Skip to main content

Authorization

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

Insightful

Prerequisites​

To connect Nexla to Insightful, you need an active Insightful account with Admin privileges. Only organization Admins can generate API tokens in Insightful.

Generate an Insightful API Token​

Insightful authenticates API requests using Bearer tokens. Follow these steps to generate a token from your Insightful organization settings:

  1. Sign in to your Insightful account at app.insightful.io as an organization Admin.

  2. Navigate to your organization settings. Look for the API or Integrations section within the Admin or Organization settings area.

  3. Click the Create new Token button to begin creating a new API token.

  4. Enter a descriptive name for the token in the name field — for example, Nexla Integration. A meaningful name helps you identify and manage this token later.

  5. Once you have entered a name, the generate button will become active. Click the button to generate the token.

Save Your Token Immediately

The API token is displayed only once at the time of creation. Copy the token value and store it in a secure location immediately after generation. You will not be able to retrieve the token value again after closing the dialog.

  1. Store the copied token value securely — you will need to paste it into Nexla when creating the credential.

For complete information about Insightful's API and token management, visit the Insightful Developer Portal.

Rate Limiting​

Insightful enforces a limit of 200 API requests per minute per organization. If this limit is exceeded, the API returns an HTTP 429 status code. Nexla manages API request frequency automatically, but this limit is worth noting when configuring high-frequency data flows.

Create an Insightful Credential​

  • To create a new Insightful credential, after selecting the data source 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 Token​

  1. Enter the Insightful API token you generated in the Prerequisites section into the API Token field. This token authenticates Nexla's requests to the Insightful API and should be kept secure.

    Nexla sends this token as a Bearer token in the Authorization HTTP header for all requests to the Insightful API, following the format required by the Insightful API:

    Authorization: Bearer <your_api_token>

    Treat your Insightful API token like a password. Do not share it in publicly accessible places such as source code repositories or client-side code. If a token is compromised, revoke it from your Insightful organization settings and generate a new one.

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 creation and can be selected for use with a new data source.