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.