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
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
​
event
string
required

Name of the action that a user has performed.

​
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.

​
context
object

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

​
files
object[]
​
properties
object

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

​
timestamp
string

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

Response

204 - application/json

An empty String

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