Sign in

v1

latestOpenAPI 3.1.02026-07-26461279.9 KB
Public Apps

The Identify call lets you tie a user to their actions and record traits about them. It includes a unique User ID and any optional traits you know about the user, like their email, name, and more.

post/api/public/apps/identify

Headers

authorizationstring required

Authorization header for the request, in the format Bearer <token>. Find your token at https://app.dittofeed.com/dashboard/settings#write-key.

Request body

OR

Example request

{
  "messageId": "23d04926-78e5-4ebc-853f-f26c84ff629e",
  "timestamp": "2024-04-22T07:00:00.000Z",
  "context": {
    "ip": "192.0.2.1"
  },
  "traits": {
    "name": "Michael Scott",
    "items": [
      {
        "id": 1,
        "name": "Paper"
      },
      {
        "id": 2,
        "name": "Stapler"
      }
    ]
  },
  "userId": "1043"
}

Response

An empty String

string required

An empty String