TrackStack Docs
TrackStack Docs
DashboardPricingTrackStack DocsQuickstartExamplesSDK SetupB2B SaaS EventsSupported PlatformsIntegrationsAPI Playground
Ingest conversion events POST
GitHub
POST
/events

Accepts batched conversion events from the SDK. Events are validated, normalized, mapped to platform event taxonomy, delivered with bounded retries, and telemetry is emitted per CAPI-enabled platform. Failed rows are written to DLQ after retry exhaustion.

Authorization

apiKey
x-ts-key<token>

TrackStack API key from dashboard

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://edge.gettrackstack.com/events" \  -H "Content-Type: application/json" \  -d '{    "events": [      {        "event": "PageView",        "eventId": "string"      }    ]  }'
{
  "status": "ok",
  "received": 0,
  "planned_rows": 0,
  "delivered_rows": 0,
  "failed_rows": 0,
  "retried_rows": 0,
  "dlq_rows": 0,
  "platform_summary": {
    "property1": {
      "planned": 0,
      "delivered": 0,
      "failed": 0,
      "retried": 0,
      "dlq": 0
    },
    "property2": {
      "planned": 0,
      "delivered": 0,
      "failed": 0,
      "retried": 0,
      "dlq": 0
    }
  }
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "traceId": "string",
  "code": "string"
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "traceId": "string",
  "code": "string"
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "traceId": "string",
  "code": "string"
}
events*array<>
Items1 <= items <= 100