Authentication

Overview

All Delivr.ai API calls require a Bearer token. This guide shows you how to get one.

Base URL: https://apiv3.delivr.ai

Step 1: Create an Account

Retrieve your invite to Delivr.ai via email or sign up at https://app-v2.delivr.ai/sign-up and verify your email.

Step 2: Login (Get JWT Token)

curl -X POST https://apiv3.delivr.ai/auth/v1/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "YOUR_EMAIL",
    "password": "YOUR_PASSWORD"
  }'

Response (200 OK)

{
  "user_id": "c5553b3d-22db-...",
  "organization_id": "bc638318-dba9-...",
  "token": "eyJhbGciOiJIUzI1NiIs..."
}

Save these values:

Field	What It Is	Where You'll Use It
`token`	Your JWT Bearer token	`Authorization: Bearer TOKEN` on all API calls
`organization_id`	Your organization	`x-organization-id` header, request bodies

Error Responses

HTTP Status	Error	Cause
404	`"User not found."`	Email not registered

Step 3: Create an API Client (Optional)

API clients provide a stable api_key for programmatic access instead of using your JWT directly.

curl -X POST https://apiv3.delivr.ai/client/v1 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My API Client"
  }'

Response (201 Created)

{
  "client_id": "5f56c253-5e18-...",
  "api_key": "dlvr_74ce9b3f761368ede79ec2db...",
  "api_secret": "99ebda82ac1cdb68f8a9ece801051e4c...",
  "created_at": "2026-01-01 10:00:00"
}

Save your api_key and api_secret now. The secret cannot be retrieved later.

List Your API Clients

curl https://apiv3.delivr.ai/client/v1 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Response

{
  "clients": [
    {
      "client_id": "5f56c253-5e18-...",
      "name": "My API Client",
      "status": "active",
      "api_keys": [
        {
          "key_id": "71a23beb-47f4-...",
          "key_prefix": "dlvr_74ce9b3...",
          "status": "active",
          "created_at": "2026-01-01 10:00:00"
        }
      ],
      "created_at": "2026-01-01 10:00:00"
    }
  ],
  "total": 1
}

The list endpoint shows a truncated key_prefix, not the full key. The full api_key and api_secret are only returned at creation time.

Delete an API Client

curl -X DELETE https://apiv3.delivr.ai/client/v1/YOUR_CLIENT_ID \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Response (200 OK)

{
  "message": "API client deleted successfully."
}

Next Steps

Account Setup -- Create your first project (required before using Events or Audiences)
On-Domain Events API -- Create a pixel and query visitor events
Intent Audiences API -- Create intent-based audiences