Motive OAuth Configuration

Overview

This guide provides detailed instructions on integrating Motive with your Terminal instance.

This is required for Motive specifically in order to guarantee:

The OAuth flow is consistent with your branding.
The permissions are customized for your specific needs.
You can publish your application on the Motive marketplace.

Creating a Developer Account

You can skip this step if you already have a Motive developer account

Create a Motive developer account by signing up here.
- Tip: use a shared email for your team as Motive does not have a multi-user feature.
Verify your email address by clicking the link in the email sent to you.
Log in to the Motive Developer Portal.
Share the email + password with the Terminal Team so we can help you complete setup.

Creating an OAuth Application

To establish an OAuth client with Motive, execute the following steps:

Create a new App:
- Log in to the Motive Developer Portal.
- Click the Create App button.
- Give your application a name and click Create App.
Navigate to Configuration
Under Success Redirect URI, input:

https://link.withterminal.com/oauth/callback/motive/{PUBLISHABLE_KEY}

Substitute {PUBLISHABLE_KEY} with your production publishable key, which is available in your Terminal dashboard. If you haven’t obtained production access to Terminal yet, you can skip this step and add the redirect URI later.

Determine the Permissions your application will require.

Here’s a breakdown of the permissions and scopes you might need from Motive, depending on the Terminal common models you plan to use.

It’s best to request all the permissions you might need upfront. Adding permissions later will require customers to re-authenticate, which can be avoided with early planning.

Common Model	Motive Scope
General (required)	`Company Details (Read Only)`
Vehicles (required)	`Vehicles (Read Only)`
Devices	`ELDs (Read Only)`
Groups	`Groups (Read Only)`
Drivers	`Drivers and Fleet Managers (Read Only)`
Latest Vehicle Locations	`Vehicles with Current Location and Current Driver (Read Only)` `Drivers with Current Location and Current Vehicle (Read Only)`
Historical Vehicle Locations Vehicle Stat Logs	`Vehicle Location History (Read Only)`
Trailers	`Assets (Read Only)`
Trailer Locations	`Asset with Asset Gateway Location History (Read Only)`
HOS Available Time	`Drivers with Hours of Service (Read Only)`
HOS Logs HOS Daily Log	`HOS Logs (Read Only)`
Safety Events	`Speeding Events (Read Only)` `Scorecards (Read Only)` `Scorecard Summary (Read Only)`
IFTA Summaries	`IFTA Trip Reports (Read Only)` `Vehicles' Mileage Summary (Read Only)`
Passthrough	Select any other scopes you plan to leverage if using passthrough

Click Save to finalize application setup.
Share the email and password of the developer account with the Terminal Team.

Update Motive Configuration in the Terminal Dashboard

You must be a Terminal Dashboard admin to perform this step.

Go to the Terminal Dashboard Settings
Scroll down to Motive
Paste the Client ID and Client Secret from Motive into the Terminal dashboard.
Click Edit Scopes to configure the scopes your application will use.
The scopes selected here should match the scopes you selected in the Motive developer portal.
Click Close to finish editing the scopes.
Click Save Changes to save the configuration.
Begin connecting Motive fleets to Terminal 🚛

Publishing Your Application

Once your integration is in production and Motive fleets have connected to your application, you can request that Motive review your application for inclusion in their marketplace.

Welcome

Introduction

Terminal API Basics

Terminal Platform

Configuration

Motive OAuth Configuration

Overview

Creating a Developer Account

Creating an OAuth Application

Update Motive Configuration in the Terminal Dashboard

Publishing Your Application

Welcome

Introduction

Terminal API Basics

Terminal Platform

Configuration

​Overview

​Creating a Developer Account

​Creating an OAuth Application

​Update Motive Configuration in the Terminal Dashboard

​Publishing Your Application

Overview

Creating a Developer Account

Creating an OAuth Application

Update Motive Configuration in the Terminal Dashboard

Publishing Your Application