Connect your fleet's Motive ELD (register the developer app)

What this does

Connecting Motive lets the app pull each driver's Hours of Service (duty status, available hours, and violations) automatically, instead of anyone typing logs in by hand. You connect once per customer account and it covers their whole fleet, every truck and driver. Nothing is installed in the trucks, and you never touch the customer's Motive billing.

This is a one-time setup. You register a single Motive "developer app," which gives you two keys (a Client ID and a Client Secret). After that, each customer just clicks Connect and approves access.

> Only ELDs certified for use in Canada are supported. Motive (formerly KeepTruckin) is on Transport Canada's certified list.

Before you start

You need admin access to a Motive account and access to Motive's developer portal. If you are not the Motive account owner, ask them to add you, or to complete these steps and send you the two keys at the end.

Step 1: Open the Motive developer portal

Go to developer.gomotive.com and sign in with your Motive account. Look for Apps, API, or Developer in the menu.

Step 2: Create a new app

Choose Create App (sometimes called "New Application" or "Register App"). Give it a name you'll recognise, such as "Cor Pathways HOS". A description like "Reads Hours of Service into our compliance app" is fine.

Step 3: Set the redirect URL (copy this exactly)

When it asks for a Redirect URL (also called "Callback URL" or "OAuth redirect URI"), paste this exactly, with no trailing space:

`` https://corpathway-non-safety-app.vercel.app/api/eld/motive/callback ``

This is the address Motive sends each customer back to after they approve access. It must match exactly or the connection will fail.

Step 4: Choose read access for Hours of Service

If the app asks which scopes or permissions it needs, select read access for Hours of Service / logs / drivers / vehicles. The app only ever reads data, it never changes anything in Motive.

Step 5: Copy the two keys

When the app is created, Motive shows a Client ID and a Client Secret. Copy both. The Client Secret is shown once: if you lose it, you can regenerate it later, but it's easiest to copy it now.

Step 6: Hand the keys to your administrator

Send the Client ID and Client Secret to whoever manages this app's settings (keep the secret private, send it through a password manager or a secure message, not plain email). They get stored as protected settings, never in the app's code, and never shown to customers.

What happens next

Once the keys are in place, the ELD Connections page (Transport → Hours of Service → ELD connections) lets a customer pick Motive from the dropdown and click Connect. They sign in to Motive, approve read access once, and their fleet's Hours of Service starts flowing into each driver's file automatically.

The same process works for other certified ELDs (Samsara, Geotab, ISAAC), each is its own one-time app registration, added as customers need them.