A Virtual Key is a digital access method required by Tesla for third-party
applications to issue commands to Tesla vehicles and the preferred method for accessing data.
Please see this
section
for more information.
Smartcar handles this step on your behalf in the Connect flow. You can get started with the default Smartcar Virtual Key with no configurations required.If you’re on an Enterprise plan, please reach out to your Account Manager or
Solutions Architect for information on setting up a custom Virtual Key with your own brand name.
Although Smartcar handles this step on your behalf, the Virtual Key URL for your application is sent back along with the authorization code after a user completes the Connect flow. You can redirect users to this URL if they need to add the Virtual Key again.
Smartcar Connect will present Tesla vehicle owners a prompt to install the Tesla Virtual Key after granting access and prior to redirecting them back to your application.
Prompting the user to add a Virtual Key
The Virtual Key is a URL in the form:
Copy
Ask AI
https://www.tesla.com/_ak/smartcar.com
After prompting your users to open the link, depending on their device, they will be redirected to the Tesla app or prompted to scan a QR code.
Adding a Virtual Key will need to be done after a user has granted your application access to their Tesla account in the Connect flow.Please see our FAQs for details on adding a virtual key for accounts with multiple vehicles and different account types.
On mobile devices, they will be redirected to the Tesla app and prompted to add the Virtual Key
Opening the link on a mobile device with the Tesla app installed
Virtual Key status can be checked at any time from the Tesla infotainment screen under Settings, Locks.
2020 and earlier Model S and X will not require a virtual key at this time. Data for these vehicles is refreshed every
5 minutes while the vehicle is awake.
What if a streaming capable vehicle does not have a virtual key installed?
If a vehicle is streaming capable and does not yet have a virtual key installed,
requests to the vehicle will be limited to 1 request every 8 hours for data. These requests will
not wake the vehicle.