Sign in
events

Bulk create events

Accepts up to 1,000 events. external_id and shopify_customer_id must already match a profile. See Bulk requests for per-item results and retry behaviour.

post/events/batch

Headers

Idempotency-Keystring

Deduplicates retries for 24 hours: the same key returns the original response with Idempotency-Replayed: true; the same key with a different body returns 409 idempotency_key_reused.

Postscript-Versionstring date
Example:2026-07-23

Overrides the key's pinned API revision for this request.

Request body

backfillboolean

Marks the whole batch as historical: stored and counted in aggregates, but never triggers flows or webhooks. Debits a separate rate window.

Example request

{
  "events": [
    {
      "identifier": {
        "type": "email"
      }
    }
  ]
}

Response

Per-item results in request order. Failed items carry a per-item error; successes carry the event reference.

Changes

No recorded changes to this endpoint across all 1 revision of this API.