DeveloperSkip to main content

  1. Documentation
  2. Charging
  1. Billing and Limits
  2. Announcements
  3. Sign In

Third-Party Business Tokens

Generate a token on behalf of a business. This allows API calls using the scopes granted by the business. Authentication endpoints are not billed. Note: third-party business tokens are incompatible with user endpoints, as there is no user context.

Vehicle access

Authorization covers vehicles associated with the business account that granted consent. This includes:

  • Vehicles owned by that business account
  • Vehicles available to that account via a Vehicle Manager relationship in Tesla for Business

When one business account grants Vehicle Manager access to another, the Vehicle Manager account can manage those vehicles. Authorizations for third-party access that are issued to a Vehicle Manager account include authorizations to vehicles under that account.

Developer administrator navigates to Tesla for Business.

Select "Account" Tab.

Select "Consent Management" under Access Management in the sidemenu.

Step 2: Generate Invitation

Click on the "Request Consent" button.

Select a developer application from the dropdown menu.

Enter email of a business admin and submit.

An email will be sent to the business contact to approve the request from 'noreply@tesla.com' with the following subject "Access Request from application_name".

Step 3: Authorize Application

Business contact opens the approval email and signs in with their admin credentials.

They will be prompted to select a business account and grant application scopes.

Step 4: Obtain Authorization Code

After access has been granted, a developer administrator can obtain the authorization code from consent management page within Tesla for Business.

Step 5: Generate Third-Party Business Token

Execute the following request to generate a token.

POST https://fleet-auth.prd.vn.cloud.tesla.com/oauth2/v3/token

Parameters

NameRequiredExampleDescription
grant_typeYesclient_credentialsGrant type must be client_credentials.
client_idYesabc-123Partner application client ID that was granted access
client_secretYessecret-passwordPartner application client secret.
scopeYesuser_data vehicle_device_data vehicle_cmds vehicle_charging_cmdsSpace delimited list of scopes
audienceYeshttps://fleet-api.prd.na.vn.cloud.tesla.comAudience for the generated token. Must be a Fleet API base URL.
auth_codeYes7baf90cda...Authorization code obtained from Step 4

Example Request

# Third-party business token request
curl --request POST \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode "client_id=$CLIENT_ID" \
  --data-urlencode "client_secret=$CLIENT_SECRET" \
  --data-urlencode "auth_code=$AUTHCODE" \
  --data-urlencode "audience=$AUDIENCE" \
  --data-urlencode "scope=$SCOPE" \
  'https://fleet-auth.prd.vn.cloud.tesla.com/oauth2/v3/token'
# Extract access_token from this response