POST /api/public/apps/identify

POST

api

public

apps

identify

The following is an example of an identify body.

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

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.

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.

application/json

messageId

string

required

Unique identifier for the message, used as an idempotency key for safe retries. Can provide a UUID.

userId

string

required

Unique identifier for the user. Should be the id of the user in your system. Only applicable to logged in users.

timestamp

string

ISO 8601 formatted timestamp of when the event occurred. If not provided, the current server time will be used.

context

object

Provides metadata about the user submitting the event and the context in which the event occurred.

traits

object

Free-form dictionary of traits of the user, like email or name. Can contain arbitrary JSON values.

204

application/json

An empty String