POST
/
api
/
public
/
apps
/
track

The following is an example of a track body.

example body
{
  "event": "Signed Up",
  "userId": "1043",
  "properties": {
    "plan": "Enterprise"
  },
  "messageId": "1ff51c9c-4929-45de-8914-3bb878be8c4a"
}

Authorizations

PublicWriteKey
string
headerrequired

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.

event
string
required

Name of the action that a user has performed.

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.

files
object[]
context
object

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

properties
object

Free-form dictionary of properties of the event, like revenue or product name. Can contain arbitrary JSON values.

Response

204 - application/json

An empty String

POST /api/public/apps/identifyPOST /api/public/apps/page