Add charge schedule

The Add charge schedule action creates a location-based charging schedule for your Tesla vehicle, or modifies an existing one. A schedule tells the car which days and times to charge while it’s parked at a particular place.

Use it to set up recurring charging at home or work, for example charging only on weekday nights when off-peak rates apply. To change an existing schedule, pass its schedule ID.

Using this action from the user interface

If you prefer building automations and scripts visually, Home Assistant walks you through this action step by step. You pick what to target, tweak a few options, and save. No YAML knowledge required.

To add a charge schedule from an automation or a script:

  1. Go to Settings > Automations & scenes.
  2. Open an existing automation or script, or select Create automation > Create new automation.
  3. If you’re setting up a new automation, add a trigger in the When section. Scripts don’t need a trigger. They run when something else calls them.
  4. In the Then do section, select Add action.
  5. From the search box, search for and select Teslemetry: Add charge schedule.
  6. Select the Vehicle to schedule.
  7. Select the Days of week the schedule should run on.
  8. Turn Enable on so the schedule is active.
  9. Optional: set the Location, Start time, End time, and a Name for the schedule.
  10. Select Save.

Options in the UI

Vehicle

The vehicle to schedule.

Days of week

The days this schedule runs on. You can select multiple days.

Enable

Whether this schedule should be active.

Location (Optional)

The approximate location the vehicle must be at to use this schedule. Defaults to your Home Assistant location.

Start time (Optional)

The time the schedule begins, for example 01:05 for 1:05 AM.

End time (Optional)

The time the schedule ends, for example 01:05 for 1:05 AM.

One-time (Optional)

Whether this is a one-time schedule.

Schedule ID (Optional)

The ID of the schedule. Use an existing ID to modify a schedule.

Name (Optional)

A name for the schedule.

Using this action in YAML

If you work directly in YAML, or you want to know exactly what Home Assistant does under the hood, this section has the technical reference. It lists the field names you use in YAML, their types, and which ones are required.

In YAML, refer to this action as teslemetry.add_charge_schedule. A basic example looks like this:

ActionActions are used in several places in Home Assistant. As part of a script or automation, actions define what is going to happen once a trigger is activated. In scripts, an action is called *sequence*. [Learn more]
action: teslemetry.add_charge_schedule
data:
  device_id: 0d462c0c4c0b064b1a91cdbd1ffcbd31
  days_of_week:
    - monday
    - tuesday
    - wednesday
    - thursday
    - friday
  enable: true
  start_time: "23:00"
  end_time: "05:00"

This adds a weekday charging schedule that runs from 11:00 PM to 5:00 AM.

Options in YAML

device_id string Required

The ID of the vehicle to schedule.

days_of_week list Required

The days this schedule runs on. Use the lowercase day names, such as monday or saturday.

enable boolean Required

Whether this schedule should be active.

location map

The approximate location the vehicle must be at to use this schedule, as a mapping with latitude and longitude. Defaults to your Home Assistant location.

start_time string

The time the schedule begins, in HH:MM format.

end_time string

The time the schedule ends, in HH:MM format.

one_time boolean

Whether this is a one-time schedule.

id integer

The ID of the schedule. Use an existing ID to modify a schedule.

name string

A name for the schedule.

Try it yourself

Ready to test this? Open Developer tools > Actions, search for this action, fill in the fields, and select Perform action. You see what happens on your actual entitiesAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] without writing a line of YAML.

Still stuck?

The Home Assistant community is quick to help: join Discord for real-time chat, post on the community forum with the action you’re calling and what you expected to happen, or share on our subreddit /r/homeassistant.

Tip

AI assistants like ChatGPT or Claude can also explain actions or suggest the right one when you describe what you want in plain language.

Related actions

These actions work well alongside this one: