Alta API Documentation

The Alta API uses Bearer token authentication. Every request must include a valid API token in the Authorization header.

Generating a token

Generate an API token from the Alta dashboard under User Profile > API tokens.

Include the token in the Authorization header:

curl https://api.altahq.com/v1/campaigns \
  -H "Authorization: Bearer YOUR_API_TOKEN"

If your user has access to multiple accounts, you must include the x-account-id header to specify which account to use:

curl https://api.altahq.com/v1/campaigns \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "x-account-id: YOUR_ACCOUNT_ID"

If you have access to only one account, this header is optional - the API uses your account automatically.

If authentication fails, the API returns a 401 Unauthorized response:

{
  "error": "Unauthorized",
  "message": "Invalid API token"
}

Common causes: