Account Setup

Overview

Before you can query events or create audiences, you need a project. This guide walks you through creating one.

Prerequisites: You need a JWT token and organization ID from Authentication.

Base URL: https://api.delivr.ai (Partner API)

The Partner API for app, project, and pixel management uses api.delivr.ai, not apiv3.delivr.ai.

Concepts

flowchart TD
    A["Organization\n(your account)"] --> B["App\n(API credentials)"]
    A --> C["Project\n(pixels + audiences)"]
    C --> D["Pixel 1\n(website tracking)"]
    C --> E["Pixel 2\n(another site)"]
    C --> F["Audiences\n(intent lists)"]
    B -.->|"client_id + client_secret\nmanages"| C

    style A fill:#3b82f6,color:#fff
    style B fill:#6366f1,color:#fff
    style C fill:#8b5cf6,color:#fff

Concept	What It Is
Organization	Your account. Created automatically when you sign up. You get the `organization_id` from the login response.
App	A set of API credentials (`client_id` / `client_secret`) for managing projects and pixels via the API.
Project	A container for your pixels and audience data. Lives under your organization.

Note: You need an app to create and manage projects via the API. The app provides the client_id and client_secret headers required for project and pixel management calls.

Step 1: Create an App

Create an app to get API credentials for project management.

curl -X POST https://api.delivr.ai/public/core/api/app/create \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My App"
  }'

Response (201 Created)

{
  "response": {
    "app_id": "b19c435b-3166-..."
  }
}

Retrieve App Details

After creating the app, retrieve it to get the client credentials:

curl https://api.delivr.ai/public/core/api/app/retrieve/YOUR_APP_ID \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Response

{
  "response": {
    "app": {
      "app_id": "b19c435b-3166-...",
      "secret": {
        "client_id": "client_IozyD02zx3imP2...",
        "client_secret": "secret_j1m442_Ynjuuj00..."
      },
      "name": "My App",
      "status": "active",
      "created_at": "2026-01-01 10:00:00"
    }
  }
}

Save the client_id and client_secret -- these are required as headers for all project and pixel management calls below.

Step 2: Create a Project

Projects are containers for your pixels and audience data.

curl -X POST https://api.delivr.ai/public/core/api/project/create \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "X-Delivr-Client-ID: YOUR_CLIENT_ID" \
  -H "X-Delivr-Client-Secret: YOUR_CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -H "organization_id: YOUR_ORGANIZATION_ID" \
  -d '{
    "project": {
      "name": "My Project"
    }
  }'

Response

{
  "response": {
    "project_id": "5b6f6b47-5ba7-..."
  }
}

Save the project_id -- you'll need it for events and audience API calls.

List Your Projects

curl https://api.delivr.ai/public/core/api/project/get \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "X-Delivr-Client-ID: YOUR_CLIENT_ID" \
  -H "X-Delivr-Client-Secret: YOUR_CLIENT_SECRET" \
  -H "organization_id: YOUR_ORGANIZATION_ID"

Response

{
  "response": {
    "projects": [
      {
        "project_id": "5b6f6b47-5ba7-...",
        "name": "My Project",
        "status": "active",
        "created_at": "2026-01-01 10:00:00"
      }
    ]
  }
}

Summary: What You Have Now

Item	Where You Got It	Where To Use It
JWT Token	Authentication Step 2	`Authorization` header on all calls
Organization ID	Authentication Step 2	`organization_id` header on project/pixel calls
App Client ID	This guide, Step 1	`X-Delivr-Client-ID` header (project/pixel management)
App Client Secret	This guide, Step 1	`X-Delivr-Client-Secret` header (project/pixel management)
Project ID	This guide, Step 2	`project_id` parameter on events and audience calls

Next Steps

You now have a project. Choose your path:

Path 1: On-Domain Events (Pixel)

Create a pixel on your project, install it on your website, and query visitor events.

On-Domain Events API

Path 2: Intent Audiences

Create intent-based audiences on your project and download the results.

Intent Audiences API