events

Create an event

external_id and shopify_customer_id also create a profile when none matches.

post/events

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

currencystring

dedupe_idstring

Deduplicates the event for 48 hours. See Idempotency.

occurred_atstring date-time

Defaults to received_at.

profile_idstring

propertiesobject required

typestring required

Lowercase dot notation, e.g. order.completed. Underscores are rewritten as dots. Platform namespaces such as sms.* and profile.* are reserved.

valuestring

Decimal string, sent with currency.

Example request

{
  "identifier": {
    "type": "email"
  }
}

Response

The created event.

Example response

{
  "data": {
    "metric": {
      "first_seen_at": "2026-07-23T17:32:01.123456Z"
    },
    "occurred_at": "2026-07-23T17:32:01.123456Z",
    "profile": {
      "created_at": "2026-07-23T17:32:01.123456Z",
      "identifiers": [
        {
          "created_at": "2026-07-23T17:32:01.123456Z",
          "type": "email",
          "updated_at": "2026-07-23T17:32:01.123456Z",
          "verified_at": "2026-07-23T17:32:01.123456Z"
        }
      ],
      "updated_at": "2026-07-23T17:32:01.123456Z"
    },
    "received_at": "2026-07-23T17:32:01.123456Z",
    "source": "api"
  }
}

Changes

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