Resolution as a Service

Step 1. Sign up as Partner

You must register in the Delivr.ai UI as a Partner and verify your account by email https://app-v2.delivr.ai/sign-up

Step 2. Login (Get JWT)

Use the public authentication endpoint to obtain your JWT:

https://docs.delivr.ai/reference/postv1authlogin-1

Step 1. Registration

Request example:

{
curl --request POST \
     --url https://apiv2.delivr.ai/auth/v1/login \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "email": "[email protected]",
  "password": "test_password"
}
'
}

Response example:

{
  "user_id": "221708ad-7dad-49e0-80bd-5884267****",
  "organization_id": "66fede73-6811-4a73-beea-461b2f****",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...****"
}

Step 3. Create App

https://docs.delivr.ai/reference/postapiappcreate

Request example:

curl --request POST \
     --url https://api.delivr.ai/public/core/api/app/create \
     --header 'authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...****' \
     --header 'content-type: application/json' \
     --data '
{
  "name": "Test Delivr App"
}
'

Response example:

{
  response": {
"app_id": "b19c435b-3166-4c8e-a78c-444d5602a0b7"
  }
}

Step 4. Retrieve App by ID

Request example:

curl --request GET \
     --url https://api.delivr.ai/public/core/api/app/retrieve/b19c435b-3166-4c8e-a78c-444d5602a0b7 \
     --header 'authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...****'

Response example:

{
"response": {
    "app": {
      "app_id": "b19c435b-3166-4c8e-a78c-***",
      "created_by_user": {
        "user_id": "221708ad-7dad-49e0-80bd-***",
        "first_name": "Test",
        "last_name": "Test",
        "email": "[email protected]"
      },
      "secret": {
        "client_id": "client_IozyD02zx3imP2***",
        "client_secret": "secret_j1m442_Ynjuuj00-TySxhSuz-8mQ9QR8bh***"
      },
      "name": "Test_delivr_ai",
      "status": "active",
      "updated_at": "2025-11-06 14:05:26",
      "created_at": "2025-11-06 14:05:26"
    }
  }
}

Step 5. Create Project

Request example:

curl --request POST \
  --url https://api.delivr.ai/public/core/api/project/create \
  --header 'X-Delivr-Client-ID: client__UpsWqRoetKxQ6CtgdU****' \
  --header 'X-Delivr-Client-Secret: secret_9C8AG1U8Tgu58Qh8JNAsXHnjQLDMUM6Zhj-****' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoiMjIxNzA4YWQtN2RhZC00OWUwLTgwYmQtNTg4NDI2N2FmNmUyIiwibWFzdGVyX29yZ2FuaXphdGlvbl9pZCI6IjY2ZmVkZTczLTY4MTEtNGE3My1iZWVhLTQ2MWIyZjcxNGRlZiIsInN1YiI6IjIyMTcwOGFkLTdkYWQtNDllMC04MGJkLTU4ODQyNjdhZjZlMiIsImV4cCI6MTc5Mzk3MzQ2NiwiaWF0IjoxNzYyNDM3NDY2fQ.ANp7n1gQ3tdcTLA91WyrIg2o_****' \
  --header 'Content-Type: application/json' \
  --header 'organization_id: 66fede73-6811-4a73-beea-461b2f7***' \
  --data '{
    "project": {
      "name": "new_test_project"
    }

Response example:

{
  "response": {
    "project_id": "5b6f6b47-5ba7-46e4-ac8f-6138c09a****"
  }
}

Step 5.1. OPTION Get list of projects

Request example:

curl --request GET \
    --url https://api.delivr.ai/public/core/api/project/get \
    --header 'authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...****' \
    --header 'organization_id: 56e97658-1a43-4665-9ab7-48e76***' \
    --header 'X-Delivr-Client-ID: client__UpsWqRoetKxQ6CtgdU***' \
    --header 'X-Delivr-Client-Secret: secret_9C8AG1U8Tgu58Qh8JNAsXHnjQLDMUM6Zhj-****'

Response example:

{
  "response": {
   "projects": [
     {
       "project_id": "5b6f6b47-5ba7-46e4-ac8f-6138c09a****",
       "name": "Project 1",
       "dark_logo_path": "",
       "light_logo_path": "",
       "number_of_employees": 0,
       "status": "active",
       "created_at": "2025-11-06 14:31:41"
     }
   ]
 }
}

Step 6. Create Pixel

Request example:

curl --request POST \
     --url https://api.delivr.ai/public/core/api/pixel/create \
     --header 'X-Delivr-Client-ID: client__UpsWqRoetKxQ6Ct****' \
     --header 'X-Delivr-Client-Secret: secret_9C8AG1U8Tgu58Qh8JNAsXHnjQLDMUM6Zhj-****' \
     --header 'authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...****' \
     --header 'content-type: application/json' \
     --header 'project_id: 4b6342ce-0be5-411b-bb16-e7347***' \
     --data '
{
  "title": "TEST PIXEL"
}

Response example:

{
   "response": {
    "pixel_id": "8a755c42-b2b1-4a59-a7d7-762076****",
    "installation_url": "https://cdn.delivr.ai/pixels/8a755c42-b2b1-4a59-a7d7-7620768****/p.js"
  }
}

Step 6.1. How to set up Pixel on your website

You can install your pixel in several ways:

Use a GMT container

Directly insert your pixel into the website’s HTML code, for example:

<script id="delivr-ai" src="https://cdn.delivr.ai/pixels/81a3ef55-565e-4db7-b1d8-9e5a2a32a52f/p.js" async></script>

Or use a more advanced option — our SDK

Step 7. Create API Client (create x-api-key)

Request example:

curl --request POST \
     --url https://apiv2.delivr.ai/client/v1 \
     --header 'accept: application/json' \
     --header 'authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoiZGNmOTA5OWUtMGU3ZS00YmE1LWFkNTEtNWE0NTIyNmM3YmMwIiwibWFzdGVyX29yZ2FuaXphdGlvbl9pZCI6IjU2ZTk3NjU4LTFhNDMtNDY2NS05YWI3LTQ4ZTc2ZmM5NGNjZCIsInN1YiI6ImRjZjkwOTllLTBlN2UtNGJhNS1hZDUxLTVhNDUyMjZjN2JjMCIsImV4cCI6MTc5Mzk3NTYwMSwiaWF0IjoxNzYyNDM5NjAxfQ.6o2uhZpDN9WAwag9417FyYqhNeFx8FM...****' \
     --header 'content-type: application/json' \
     --data '
{
  "name": "test"
}
'

Response example:

{
  "client_id":"69ee5598-b550-46e4-a7cf-c1a9124c***",
  "api_key":"dlvr_f0997864bf3db3bc99d68864e72***",
  "api_secret":"b0b1b44a54c8fe77bda7634e9e86da00883a20c92ceabb521ad01e4d654***",
  "created_at":"2025-11-06 14:49:50"
}

📘
api_key=x-api-key

🎉Now you are ready to receive events and resolutions

You have all the required parameters. Please go to the Events tab of our DELIVR.AI RESOLUTIONS & EVENTS API in the API Reference, where you will find three endpoints:

Retrieve the event schema
Count events from the event store
Query events from the event store