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_id
string
required

The application’s unique identifier.

redirect_uri
string
required

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_type
string
required

This value must be set to vehicle_id.

vehicle_id
string
required

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

user
string

Specify a unique identifier for the vehicle owner to track and aggregate analytics across Connect sessions for each vehicle owner on Dashboard.

Note: Use the state parameter in order to identify the user at your callback URI when receiving an authorization or error code after the user exits the Connect flow.