Event Ingestion API

Endpoint

POST /v1/events/ingest

Required Fields

• event_name - the name of the event (e.g., "purchase", "registration")
• workspace_id - your workspace identifier

Optional Fields

• telegram_id - Telegram user ID for attribution
• session_id - link to a tracking session
• revenue - monetary value
• currency - ISO 4217 currency code
• event_data - JSON object with custom properties

Batch Ingestion

For high-volume scenarios, use the batch endpoint:

POST /v1/events/ingest/batch

Send up to 100 events in a single request. Events are processed asynchronously and appear in analytics within seconds.