Skip to main content

Authorization

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

Bluetally

Prerequisites​

The Bluetally connector authenticates with the BlueTally REST API using an API key passed as a Bearer token in the Authorization header. To create a Bluetally credential in Nexla, you must first generate an API key from your BlueTally account.

Generate a BlueTally API Key​

  1. Sign in to your BlueTally account at https://app.bluetallyapp.com.

  2. Click the Profile icon in the top right corner of the screen.

  3. Click the Settings link in the dropdown menu to open the account settings.

  4. Click the API Keys link on the left side of the settings screen.

  5. Click the Create API Key button to generate a new API key.

  6. Provide a descriptive name for the key (e.g., "Nexla Integration") and confirm creation.

  7. Copy the generated API key and store it in a secure location. This key will be used to authenticate Nexla with the BlueTally API.

    Important

    The API key is displayed only once at creation time. Copy and store it securely before navigating away. If the key is lost, you will need to create a new one.

For complete information about BlueTally API authentication, base URLs, rate limits (10,000 requests per hour, up to 1,000 results per request), and multi-tenant considerations, refer to the BlueTally API documentation.

Multi-Tenant Accounts​

If your BlueTally account is configured for multi-tenant use, you must include the tenant_id query parameter in API requests. Several endpoint templates in this connector expose a Tenant ID field for this purpose. Identify the correct tenant ID for the data you intend to read or write before configuring endpoints that require it.

Create a Bluetally Credential​

  • To create a new Bluetally 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​

The Bluetally connector uses API key authentication. Nexla automatically sets the Authorization header to Bearer <your-api-key> for all requests to the BlueTally API.

  1. Paste the API key generated in the Prerequisites section into the API Key field. This value is stored securely and used as the Bearer token for all API calls to your BlueTally account.

    Treat your BlueTally API key as a sensitive credential. Anyone with access to the key can create, read, update, and delete records in your BlueTally account through the API.

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.