Skip to main content
POST
cURL
The following is an example of a screen body.
example body

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
messageId
string
required

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

Example:

"23d04926-78e5-4ebc-853f-f26c84ff629e"

userId
string
required

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

Examples:

"1043"

"user-123"

"0a58e5e4-c753-477e-a6c4-f9b0e3396b9b"

timestamp
string

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

Example:

"2024-04-22T07:00:00.000Z"

context
object

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

Example:
name
string

Name of the screen visited by the user.

Example:

"Home"

properties
object

Free-form dictionary of properties of the screen, like title.

Example:

Response

An empty String

An empty String