Authentication

We use a simple and secure authentication system. You must get an API key from the Motive dashboard, and provide that key on every API request. You can create multiple API keys for your company. If a key needs to be disabled because someone with it leaves the company or if it gets shared accidentally, you can disable it in the Motive dashboard. You should not share your API key with anyone outside your organization.

API keys can be configured for “test mode” or “live mode”. A test API key will never modify data and is useful when developing your integration. Use a test API key to experiment with the API without accidentally making unwanted changes to your company profile or fleet.

To authenticate, the API client must include a Company API key in an HTTP header.

Header NameValue
X-Api-Key

You can take the following steps to generate your API key:

Generate an API Key

  1. Log in to the Motive Dashboard using your credentials.
  2. At the bottom of the menu, click the admin icon (first icon).
    The admin view appears.
  3. Scroll down to locate and select the Developers option.
  4. On the Developers page, click +Request API Key.
    A pop-up appears.
  5. Provide a name for the API key OR you may directly click Save.
    You have now successfully generated an API key for yourself. Repeat the steps if you want to generate another API Key. Motive allows you to generate multiple API keys for multiple applications.
    The Developers page will display all the API keys that you generate for your organisation.