Registering Your App

Before you can call the Integrations API, you need a client ID. This page walks through getting developer access and registering an app on your Service Road Atlas account.

1. Request developer access

Developer access is gated — we approve accounts individually. From your profile, open Edit Profile → Request Developer Access. We'll email you when your account has been approved.

If you've already been approved, skip to step 2.

2. Open the developer dashboard

Once approved, a Developer Dashboard button appears on your profile. The dashboard lives at /developer and lists every application you've registered along with its client ID.

3. Register a new application

Click Register Application on the dashboard. The form asks for:

• Application name — shown on the consent screen when a user authorizes your app. Keep it short and recognizable.
• Description — a one-liner shown beneath the name on the consent screen. Describe what your app does with the user's account.
• Redirect URIs — one per line. These are the URLs we'll redirect back to after a user approves access. Non-loopback URIs must use https; custom schemes (yourapp://auth/callback) are allowed for mobile apps. You can register up to five.
• App logo — a square image at least 250×250 pixels. Shown on the consent screen next to your app name. We'll shrink and center-crop it to 250×250 automatically.
• Scopes — tick only the scopes your app actually needs. Users see every scope on the consent screen, so narrower requests get better approval rates. See Authentication for the full list.

Save the form. You'll land on the application's detail page.

4. Grab your client ID

The detail page shows your client ID — a UUID like 3f2a9b8e-.... Copy this into your app's configuration. There is no client secret: apps use OAuth 2.0 with PKCE, so the client ID alone identifies your application and the PKCE challenge proves the request is legitimate. Read Authentication for the full flow.

5. Build and test

Point your app at:

https://backroadstatus.com/oauth2/authorize
https://backroadstatus.com/oauth2/token
https://backroadstatus.com/api/integrations/v1/...

Use a Service Road Atlas account you own as the test user. The first time you authorize, you'll see the consent screen with your app's logo, name, description, and the scopes you requested.

Managing your app

From the dashboard, click Manage on any app to:

• Update the name, description, redirect URIs, scopes, or logo.
• See when the app was registered and last updated.
• Delete the app. This immediately invalidates the client ID and all tokens issued to it.

If your app gets blocked

Occasionally we may block an application temporarily — for example, if it starts behaving in a way that violates the terms of service. A blocked app shows a red Blocked badge on your dashboard and a notice on the manage page. While blocked:

• New authorization requests fail with an "unknown client" error.
• Refresh token exchanges fail.
• Already-issued access tokens continue to work until they expire (up to one hour).

Contact support at info@backroadstatus.com if you believe your app was blocked in error.