Events
POST /v1/events records usage, up to 500 events per request.
POST /v1/events records usage. Send up to 500 events per request.
| Field | Type | Notes |
|---|---|---|
customer_id |
string | Your id for the customer being billed |
event_name |
string | Matches a meter’s event_name |
timestamp |
string | RFC 3339, UTC; within the last 35 days |
properties |
object | Fields a meter can aggregate; numbers for sum and max |
Headers: Authorization: Bearer <api-key>, and Idempotency-Key (a UUID per
batch). A repeated key within 24 hours returns the first response. See
Idempotency and retries.
Response: {"accepted": 498, "duplicates": 2}. Events with a known
(customer_id, event_name, timestamp, properties.id) count as duplicates.
Bodies are JSON. For bulk loads, send batches of 500 rather than one event per request: see Rate limits. Exports of these events come back as CSV, one row per event; some teams convert them to JSON Lines.