Track a user event

POST

/api/v1/events/track

events

Last modified:2026-06-04 22:55:16

Log an in-app event for the authenticated user. Pass the event_name from the /lookup/core events list.

Request: Bearer token

Body: event_name (from /lookup/core), plus event context fields

Success: 200 - returns { success, message } only (no data).

Errors: 401 - invalid token | 404 - unknown event_name | 422 - missing fields

Request

Body Params application/jsonRequired

Example

{
    "event_name": "app_opened"
}

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/events/track' \
--header 'Content-Type: application/json' \
--data '{
    "event_name": "app_opened"
}'

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Event tracked successfully"
}

🟠401Unauthorized

🟠404Record Not Found

🟠422Parameter Error

Modified at 2026-06-04 22:55:16