Ingestion API

Every SDK sends data to one place: POST /v1/batch.

● http

POST /v1/batch
Content-Type: application/json
Authorization: Bearer <api-key>

● json

{
  "batch": [{
    "type": "<canonical-event-type>",
    "timestamp": "<ISO-8601>",
    "context": { "tenantId": "…", "sessionId": "…", "anonymousId": "…" },
    "properties": {}
  }],
  "consents": { "analytics": true, "marketing": false }
}

All ingestion paths

Path	Endpoint	Metering
SDK	`POST /v1/batch`	`sdk_event_ingested`
Connector pull	`/v1/integrations/connectors/{type}/sync`	`connector_sync`
Public webhook	`/v1/integrations/webhooks/{type}`	`webhook_ingested`
External feed	`POST /v1/ingest/feed`	`event_ingested`

▲Deprecated/v1/ingest/events and /v1/ingest/events/batch are server-to-server aliases. SDKs must not use them.