There will be times when a user updates credentials to their connected services account. When this happens, the user will need to go through Connect again to update your authorization through Smartcar.

You can do this with a streamlined Connect flow using a special re-auth URL with the parameters below.

The AUTHENTICATION_FAILED API error contains a partially constructed re-authentication URL in the resolution.url field.


client_idrequired
string

The application’s unique identifier.

redirect_urirequired
string

The URI a user will be redirected to after authorization. This value must match one of the redirect URIs set in the credentials tab of the dashboard.

response_typerequired
string

This value must be set to vehicle_id.

vehicle_idrequired
string

The id of the vehicle you are reauthenticating.

state
string

An optional value included as a query parameter in the redirect_uri back to your application. This value is often used to identify a user and/or prevent cross-site request forgery

HTTP/1.1 302 Found
Location: https://connect.smartcar.com/oauth/reauthenticate?
  response_type=vehicle_id
  &client_id=8229df9f-91a0-4ff0-a1ae-a1f38ee24d07
  &vehicle_id=sc4a1b01e5-0497-417c-a30e-6df6ba33ba46
  &redirect_uri=https://example.com/home
  &state=0facda3319