Events API

Track Events

Send events from your server.

Endpoint

POST /api/v1/track

Request

{
  "events": [
    {
      "event_type": "purchase",
      "user_id": "user_123",
      "anonymous_id": "anon_456",
      "timestamp": "2024-01-15T10:30:00Z",
      "event_attributes": {
        "order_id": "ORD-789",
        "revenue": 99.00
      }
    }
  ]
}

Response

{
  "success": true,
  "accepted": 1
}

Batch Events

Send up to 100 events per request.

Event Schema

Field	Type	Required
event_type	string	Yes
user_id	string	No*
anonymous_id	string	No*
timestamp	ISO8601	No
event_attributes	object	No

*Either user_id or anonymous_id is required.