Connect Playground
Creating your Connect URL can be easily done through the Dashboard’s new Playground feature.
Your Connect URL gives a path for vehicle owners to provide consent for requested data and/or commands. While this can be done following our Build the Connect URL guide, you can also build the URL through the Smartcar Dashboard.
With the Generated Connect URL preview, you can see how your adjustments change the vehicle-owner facing URL.
1. Basic Settings
Client ID
Your Client ID will automatically populate for the selected Dashboard application.
Redirect URI
Select from one of your pre-existing Redirect URIs, or add it now.
Mode
Select from Live or Simulated mode.
2. Permissions
In this step, select which permissions your application will request from the vehicle. This may include read access to data like odometer or location, or commands that may lock or unlock the vehicle.
Requested permissions will be presented to the vehicle owner for confirmation before connecting.
3. Advanced Settings
Optional advanced settings can be added to your Connect URL.
State
State is an optional value included as a query parameter in the REDIRECT_URI back to your application.
User
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.
Make
Allows users to bypass the Brand Selector screen. Valid makes can be found in the makes section on API reference.
The single_select_vin parameter takes precedence over this parameter.
Country
The two-character ISO country code of the country that your user is located in. You can set the default country for Connect on Dashboard
If no flag is passed or set as default on Dashboard, Smartcar will use the devices IP to set an appropriate country.
This flag determines what brands are listed on the Brand Selector screen in Connect e.g. Renault is available in Europe, but not the US.
Vehicle Single Select
Sets the vehicle selection behavior of the grant dialog. If enabled, then the user is only allowed to select a single vehicle.