Batching

This page shows how to send many events to Tidings in one request. The same endpoint that takes a single event also takes an array of them, which is what you want for backfills, mobile clients, and background workers.

Wrap up to 500 events in an events array to cut round-trips — useful for backfills, mobile clients, and background workers. A batch counts as a single request against the rate limit.

request bodyjson

{
  "events": [
    {"name": "page_view", "distinct_id": "user_42"},
    {"name": "plan_upgraded", "distinct_id": "user_42", "properties": {"plan": "pro"}}
  ]
}

A batch over 500 events is rejected with 400 — split it into multiple requests.