Purpose: The purpose of this endpoint is to identify a company, by using an access token. To use the access token, you must first generate one.

Below are the steps for generating an access token:

Generate an access token

📘

PREREQUISITES

You must meet the following requirements for generating an access token:

1. Create a developer account
2. Create an application
3. Create a fleet in Motive

After Motive associates your application to the master fleet, you must generate an access token for your company.

Take the following steps:

Step 1: Trigger the initial OAuth call

1. Log in to your fleet on the Motive platform.
2. Paste the following link. Ensure to add your own parameters for the variables.
   1. https://gomotive.com/oauth/authorize?client_id=<YOUR_CLIENT_ID>&redirect_uri=<YOUR_RE
      DIRECT_URI>&response_type=<code>&scope=<scopes>

The platform will redirect you to the corresponding URL, and prompt you to install the app.

3. Click Install.
   You will be redirected to the provided URI. The Motive platform will also generate an authorization code and append the same to the URL.
4. Make a note of the authorization code that is captured by your listener.

Step 2: Generate an access token

1. Call the following endpoint:

2. curl -X POST 'https://keeptruckin.com/oauth/token' -d
   'grant_type=authorization_code&code=<AUTH_CODE>&redirect_uri=<REDIRECT_URI>&client_id=
   <CLIENT_ID>&client_secret=<CLIENT_SECRET>’
   

   Ensure to add the following variables:

After you make the POST call, you will receive from the platform with the following info:

{
"access_token": "YOUR ACCESS TOKEN",
"token_type": "Bearer",
"expires_in": 7200,
"refresh_token": "YOUR REFRESH TOKEN"
}

Now you have successfully generated your access token.

curl -X POST 'https://keeptruckin.com/oauth/token' -d
'grant_type=refresh_token&refresh_token=YOUR_REFRESH_TOKEN_HERE&redirect_uri=RE
DIRECT_URI&client_id=CLIENT_ID&client_secret=CLIENT_SECRET’

After you generate your access token, you can now use it to confirm the identity of a company.

👍

Endpoint Header

Mention the access token in the header of the v1/companies endpoint as a Bearer Token in the headers section.