Implement Smartcar Connect OAuth with correct scopes

domain: smartcar.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. From your Smartcar dashboard, set an allowed redirect URI and note your Client ID.
  2. Construct the authorization URL: https://connect.smartcar.com/oauth/authorize?response_type=code&client_id={clientId}&redirect_uri={redirectUri}&scope={spaceDelimitedScopes}&state={csrfToken}. Include only the scopes you need, such as read_vehicle_info, read_odometer, read_fuel, read_battery, read_location, read_vin, control_security.
  3. Redirect the vehicle owner to the authorization URL; they authenticate with their OEM credentials and grant consent.
  4. After consent, Smartcar redirects to your redirect URI with a code parameter; exchange it via POST https://auth.smartcar.com/oauth/token with grant_type=authorization_code, code, redirect_uri, and Base64-encoded Basic Authorization header of clientId:clientSecret.
  5. Store the returned access_token (1-hour TTL) and refresh_token (long-lived); use the refresh_token grant to obtain new access tokens.
  6. In v3, pass the sc-user-id header on vehicle API requests to scope the application-level token to a specific user.

Known gotchas

Related routes

Handle Smartcar OAuth consent flow and configure scopes per vehicle make
smartcar.com · 5 steps · unrated
Use the Smartcar Compatibility API to check whether a specific vehicle VIN supports the data scopes your app needs before starting the OAuth Connect flow
smartcar.com · 5 steps · unrated
Configure the Smartcar Connect authorization flow to restrict users to linking a single specific vehicle and to run against simulated vehicles during development
smartcar.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans