Tesla Fleet

The Tesla Fleet integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] lets you control Tesla vehicles and energy sites using the Tesla Fleet API.

Prerequisites

You need to configure developer credentials and host a public key file to allow Home Assistant to communicate with your Tesla account.

• A Tesla account with verified email
• A web domain to host your public key file:
  • NGINX Home Assistant SSL proxy Add-on (recommended)
  • External hosting service (FleetKey.cc, MyTeslamate.com, etc.)

Tesla Developer Application

Create a Tesla Developer Application to connect Home Assistant with the Tesla Fleet API.

1. Create a developer application:

   • Go to developer.tesla.com/request
   • Select your Tesla account from the dropdown

2. Enter application details:

   • Application name: A name to identify the application
   • Description: Enter a brief description of your integration
   • Purpose of Usage: Explain how you’ll use the API (e.g., “Home Assistant”)

3. Configure client details:

   • OAuth Grant Type: Select Authorization Code and Machine-to-Machine
   • Allowed Origin URL(s): Enter your domain’s URL, for example https://yourdomain.com/
   • Allowed Redirect URI: Enter https://my.home-assistant.io/redirect/oauth
   • Allowed Returned URL(s): Leave this field empty (not required)

4. Select desired API scopes:

   • Vehicle Information (mandatory for vehicles)
   • Vehicle Location (recommended)
   • Vehicle Commands (recommended)
   • Energy Product Information (mandatory for energy products)
   • Energy Product Settings (recommended)

5. Set up billing (optional):

   • Tesla provides $10 monthly credit for personal use
   • You can add billing details later if needed

6. Save your credentials:

   • After creating the application, go to View Details > Credentials & APIs
   • Note your Client ID and Client Secret - you’ll need these to configure Home Assistant.

Configuration

To add the Tesla Fleet integration to your Home Assistant instance, use this My button:

1. Add application credentials

   • Enter your application Client ID and Client Secret from your Tesla Developer Application
   • This step will be skipped if you already have exactly one Tesla Fleet application credential already configured

2. Authenticate with Tesla:

   • You’ll be redirected to Tesla’s login page
   • Enter your Tesla account credentials
   • On the authorization page, select Select All and then Allow to allow all the scopes you previously selected

3. Redirect to Home Assistant:

   • Confirm you want to Link account to Home Assistant

4. Enter domain

   • Enter the domain name you intend to host your public key on
   • This domain should be the same or a subdomain of your origin domain, and must use a valid SSL certificate.

5. Register public key

   • Upload the public key shown to the domain you entered in step 4 at .well-known/appspecific/com.tesla.3p.public-key.pem

6. Install Virtual Key

   • Use your smartphone to scan the QR code or enter the address to install your public key on your vehicles with the Tesla app.
   • This process needs to be repeated for each vehicle, excluding Model S and Model X vehicles manufactured before 2021.

Hosting with NGINX Add-on (optional)

1. Create the NGINX configuration:

   echo 'location /.well-known/appspecific/com.tesla.3p.public-key.pem {
   root /share/tesla;
   }' > /share/nginx_proxy_default_tesla.conf
   

2. Copy the public key shown during setup to /share/tesla

3. Configure the NGINX Add-on:

   • Go to Settings > Add-ons > NGINX Home Assistant SSL proxy > Configuration
   • Change customize.active from false to true
   • Leave config.default at its default value: nginx_proxy_default*.conf

4. Restart the NGINX Add-on and verify your public key is accessible at: https://yourdomain.com/.well-known/appspecific/com.tesla.3p.public-key.pem

Data updates

The integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] pollsData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] each vehicle every 10 minutes while it’s awake. This is designed to stay within Tesla’s $10 monthly credit for most users, which you can monitor usage in the Tesla Developer Dashboard. Energy product APIs are free to use.

If you need different polling intervals, you can define a custom polling interval.

Command signing

Certain vehicles, including all vehicles manufactured since late 2023, require vehicle commands to be signed with a private key. All actionsActions 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] on vehicle 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] will fail with an error if this is required and the key has not been setup correctly.

Your public key must be added to each of these vehicles by visiting https://tesla.com/_ak/YOUR_DOMAIN and following the instructions in the Tesla app. If you’re using an iPhone, you may need to use Safari to open the webpage and finish the setup.

For more details see Tesla Fleet API vehicle commands documentation.

Generating your own key pair

The integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] generates a private key automatically at config/tesla_fleet.key. You can replace it with your own key (such as one from another Home Assistant instance) before configuring the integration. You can generate your own key pair following Tesla’s documentation.

Entities

These are the entities available in the Tesla Fleet integration. Not all entities are enabled by default, and not all values are always available.

Vehicles

Energy sites

Wall connector

Vehicle sleep

Constant API pollingData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] will prevent most Model S and Model X vehicles manufactured before 2021 from sleeping. The integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] automatically stops pollingData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] these vehicles for 15 minutes after inactivity. You can call the homeassistant.update_entity 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] to force pollingData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more], which will reset the timer.

Removing the integration

To remove an integration instance from Home Assistant

1. Go to Settings > Devices & services and select the integration card.
2. From the list of devices, select the integration instance you want to remove.
3. Next to the entry, select the three dots menu. Then, select Delete.

• Removing the integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] does not delete your Tesla Developer Application - you can remove it manually from the Tesla Developer Dashboard if no longer needed.

Troubleshooting

• Setup errors: Verify your public key is accessible at the correct URL and you’ve completed all registration steps with Tesla
• Command failures: Ensure tesla_fleet.key exists in your Home Assistant config directory and add your public key to vehicles via https://tesla.com/_ak/YOUR_DOMAIN
• IntegrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] stopped working: Use the reconfigure option in Settings > Devices & services > Tesla Fleet
• Billing errors: Check your Tesla Developer Dashboard for usage limits and add billing information if needed

If you have an error with your credentials, you can delete them in the Application Credentials user interface.