POST /api/public/apps/identify
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.
The following is an example of an identify body.
{
"userId": "532",
"traits": {
"email": "[email protected]"
},
"messageId": "6f5f436d-8534-4070-8023-d18f8b78ed39"
}
Authorizations
Authorization header for the request, in the format Bearer <token>
. Find your token at https://app.dittofeed.com/dashboard/settings#write-key.
Headers
Authorization header for the request, in the format Bearer <token>
. Find your token at https://app.dittofeed.com/dashboard/settings#write-key.
Body
Unique identifier for the message, used as an idempotency key for safe retries. Can provide a UUID.
ISO 8601 formatted timestamp of when the event occurred. If not provided, the current server time will be used.
Provides metadata about the user submitting the event and the context in which the event occurred.
Free-form dictionary of traits of the user, like email or name. Can contain arbitrary JSON values.
Unique identifier for the user. Should be the id of the user in your system. Only applicable to logged in users.
Response
An empty String