POST
/
api
/
public
/
apps
/
identify
curl --request POST \
  --url http://localhost:3001/api/public/apps/identify \
  --header 'Content-Type: application/json' \
  --header 'PublicWriteKey: <api-key>' \
  --header 'authorization: <authorization>' \
  --data '{
  "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"
}'
"<string>"

The following is an example of an identify body.

example body
{
  "userId": "532",
  "traits": {
    "email": "[email protected]"
  },
  "messageId": "6f5f436d-8534-4070-8023-d18f8b78ed39"
}

Authorizations

​
PublicWriteKey
string
header
required

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

Headers

​
authorization
string
required

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

Body

application/json

Response

204
application/json

An empty String

POST
/
api
/
public
/
apps
/
identify
curl --request POST \
  --url http://localhost:3001/api/public/apps/identify \
  --header 'Content-Type: application/json' \
  --header 'PublicWriteKey: <api-key>' \
  --header 'authorization: <authorization>' \
  --data '{
  "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"
}'
"<string>"

The following is an example of an identify body.

example body
{
  "userId": "532",
  "traits": {
    "email": "[email protected]"
  },
  "messageId": "6f5f436d-8534-4070-8023-d18f8b78ed39"
}

Authorizations

​
PublicWriteKey
string
header
required

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

Headers

​
authorization
string
required

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

Body

application/json

Response

204
application/json

An empty String