Send Events

Send events to the ingest API on port 8087 in local development.

Prerequisites:

An access token from Get an Access Token.
A registered schema from Register an Event Schema.

TOKEN="$(just dev-hydra-token)"

curl -sf -X POST http://localhost:8087/api/v1/events \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "eventTypeSlug": "page-view",
    "schemaVersion": "1.0.0",
    "timestamp": "2026-05-27T12:00:00.000Z",
    "context": { "device": { "type": "desktop" } },
    "payload": { "example": true }
  }'

Batch sends use /api/v1/events/batch and return per-event results[]. Treat any success: false result as a failed send even if the HTTP status is 202.

Send Events​

Send Events