Skip to main content

Authorization

Follow this guide to create a new Fleetio credential that will allow Nexla to authenticate to and exchange data with your Fleetio account.
fleetio_api_auth.png

Fleetio

Prerequisites​

To authenticate Nexla with the Fleetio API, you will need two credentials from your Fleetio account: an API Key and your Account Token. Both are required for every API request made to Fleetio.

Obtain Your Fleetio API Key​

Fleetio API keys are generated from within the Fleetio web application. Each API key is associated with a specific Fleetio user and inherits that user's permissions within the account.

  1. Sign in to your Fleetio account at https://secure.fleetio.com.

  2. Open the Account Menu (your user avatar or name in the top-right corner of the screen) and select Settings.

  3. In the Settings sidebar, click Manage API Keys.

  4. Click the + Add API Key button to create a new key.

  5. Enter a descriptive Label for the key (for example, Nexla Integration) to help identify its purpose.

  6. Select the API Version from the dropdown menu. Fleetio recommends using the latest available version.

  7. Click Save. The generated API key will appear under the Token column next to your chosen label. Copy this value for use in Nexla.

Important

Copy and store the API key immediately after it is generated. For security reasons, Fleetio does not display the full key value again after you navigate away from the Manage API Keys page. Treat this key as a password—do not share it publicly or commit it to source control.

Locate Your Fleetio Account Token​

The Account Token is a unique identifier for your Fleetio organization account. It is required as a separate request header on every API call in addition to your API key.

  1. Sign in to your Fleetio account at https://secure.fleetio.com.

  2. Look at the URL in your browser's address bar on any Fleetio page. The URL follows the format https://secure.fleetio.com/{account_token}/....

  3. The path segment immediately following .com/ is your Account Token. For example, if the URL is https://secure.fleetio.com/abc123/dashboard, then abc123 is your Account Token.

Additional details about Fleetio API keys and authentication are available in the Fleetio Developer Portal Quick Start guide and the Fleetio API Keys Help Center article.

Create a Fleetio Credential​

  • To create a new Fleetio credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used to provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

API Key Authentication​

Fleetio uses API Key authentication. Every API request to Fleetio must include two authentication values: an API key sent in the Authorization header (formatted as Token {your_api_key}) and an Account Token sent in the Account-Token header. Nexla handles both header values automatically once you supply them in the credential form.

  1. Enter your Fleetio API key in the API Key field. This key authenticates Nexla as a valid API consumer on behalf of your Fleetio user account. Nexla sends this value in the Authorization header as Token {api_key} on every request.

  2. Enter your Fleetio Account Token in the Account Token field. This token identifies the Fleetio organization account that all requests should target. Nexla sends this value in the Account-Token header on every request.

    Both the API Key and the Account Token are required. Requests that are missing either value will be rejected by the Fleetio API with an authentication error. Keep both values secure and do not share them in code repositories, chat messages, or other public locations.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.