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. This value is often used to identify a user and/or prevent cross-site request forgery.

​

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.