Authorize a new connected vehicle
With a pending connected vehicle, the authorization process can be continued. Make sure to follow the provider-specific instructions in the first step before continuing. It's also recommend to create a subscription, as explained in the previous section.
Mutation
To authorize a new connected vehicle provide the id
argument. Each provider requires an options
argument. Details can be found below.
Enode
After completing the make specific authorization flow initiated by authorization_url
, the authorizeConnectedVehicle
operation should be executed to validate that the vehicle is successfully authorized. The options argument can be an empty object.
Arguments
input • AuthorizeConnectedVehicleInput
Other fields
id • ID
Unique ID of the connected vehicle
vehicle_id • ID
Unique ID of the vehicle
status • ConnectedVehicleStatus
Status of the connected vehicle
Show ConnectedVehicleStatus enum values
provider • CarConnectivityProvider
Connectivity provider
Show CarConnectivityProvider enum values
scope • ConnectScope
Scope for accessing the vehicle
Show ConnectScope enum values
label • String
Custom label for a connected vehicle that can be assigned by a user
vin • String
Vehicle identification number, unique identifier for a vehicle
Response
A response can either contain a data
or an
errors
object. The response header will always return
200
as a status code.
Data object
When successful, a data
object will be returned with the
requested fields. If there are no fields present the
data
object will return the operation name with the
appropriate return type. If the operation was a query, this output
will be an object of the schema’s query root type; if the operation
was a mutation, this output will be an object of the schema’s mutation
root type.
Error object
If unsuccessful, an errors
object will be returned with
more details in the extensions
object. The error object
can contain any of the following objects.
Error
AUTH_CODE_INVALID
The provided auth code is not valid.
Error
AUTH_TOKEN_EXPIRED
The token you provided is expired.
Error
AUTH_TOKEN_INVALID
The token you provided is invalid.
Error
CONNECT_PROVIDER_NOT_ALLOWED
The Connect provider $PROVIDER is not configured for your client id. Please contact customer support to enable it!
Error
CONNECT_VEHICLE_NOT_SUPPORTED
The provider you tried to use ($PROVIDER) cannot be used for this vehicle.
Error
CONNECTED_VEHICLE_FORBIDDEN
The vehicle does not seem to be authorized yet. To complete this action, first complete the authorization flow.
Error
CONNECTED_VEHICLE_NO_PENDING_STATUS
The connected vehicle you are trying to authorize does not have status pending_authorization.
Error
CONNECTED_VEHICLE_NOT_FOUND
The connected vehicle was not found.
Error
OPERATION_NOT_ALLOWED
You are not allowed to execute this operation. Enable it for the current application in the dashboard or reach out to customer support.