How to obtain your Axiom API token

OverviewCopy Anchor Link

To authenticate with Axiom, you will need:

1. Edge / region (subdomain) – For ingest and query, use your edge deployment; for all other endpoints you can use the default (api).
2. API token – A key that grants Tenklo permission to interact with Axiom's API resources and services.

This guide covers configuring the base domain and creating an API token (basic or advanced).

PrerequisitesCopy Anchor Link

• An Axiom account

Step 1: Finding your subdomainCopy Anchor Link

The base domain of an API request depends on the operation:

• Ingest and query – Use the base domain of your edge deployment (see table below).
• All other API endpoints – Use api.

In Tenklo, enter the subdomain that corresponds to your edge (the part before .axiom.co):

Step 2: Generating your API tokenCopy Anchor Link

1. In Axiom, go to Settings → API tokens, then click New API token.
2. Name your API token.
3. Optional: Add a description and set an expiration date.
4. Under Token permissions:
   • Basic – for ingesting data; select which datasets the token can access.
   • Advanced – for querying, managing datasets, and other actions; select datasets and actions.

5. Click Create.
6. Copy the API token and store it securely. It won’t be shown again.

Generate API tokens when needed instead of Personal access tokens (PAT), as PATs provide full control over your Axiom account.

Step 3: Enter credentials in the Connect UICopy Anchor Link

Once you have your API token:

1. Open the form where you need to authenticate with Axiom
2. Enter your API token in their respective fields
3. Submit the form, and you should be successfully authenticated

You are now connected to Axiom.