Getting Started
Authentication

Authentication

Every request to the Adzen API must include your subscription key in the X-API-Key header.

POST /ugc/process HTTP/1.1
Host: api.adzen.ai
X-API-Key: your-subscription-key
Content-Type: application/json
⚠️

Never commit API keys to source control. Store them in environment variables or a secrets manager (Azure Key Vault, AWS Secrets Manager, etc.).

Getting a key

  1. Contact your Adzen account representative to be onboarded.
  2. You will receive a sandbox key (prefixed sandbox-) for development.
  3. Once your integration passes QA, you will receive a production key (prefixed prod-).

Key rotation

Adzen keys rotate automatically every 90 days. Your previous key remains valid as a secondary key for 24 hours after rotation. You can trigger a rotation on demand by calling GET /keys/apiKey — the response returns both the new primary key and the previous key as the secondary, along with the expiry timestamp.

See API Reference → GET /keys/apiKey for the full contract.