​
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
  1. 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.
  2. Verify your email address by clicking the link in the email sent to you.
  3. Log in to the Motive Developer Portal.
  4. 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:
  1. 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.
  2. Navigate to Configuration
  3. 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.
  1. Determine the Permissions your application will require.
  1. Click Save to finalize application setup.
  2. Share the email and password of the developer account with the Terminal Team.

​
Update Motive Configuration in the Terminal Dashboard

If you haven’t obtained production access to Terminal yet, you can skip this step and complete it when you have production access.You must be a Terminal Dashboard admin to perform this step.
  1. Go to the Terminal Dashboard Settings
  2. Scroll down to Motive
  3. Paste the Client ID and Client Secret from Motive into the Terminal dashboard.
  4. 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.
  5. Click Close to finish editing the scopes.
  6. Click Save Changes to save the configuration.
  7. 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. Contact us when ready, and we’ll help introduce you to the Motive team to expedite the review process.