Events

Create event

Authentication

X-Schematic-Api-Keystring
API Key authentication via header

Request

This endpoint expects an object.
event_typeenumRequired
Either 'identify' or 'track'
backfillboolean or nullOptional

Requires a secret API key, and trusted_client_clock. Import historical data without affecting billing.

bodyobjectOptional
idempotency_keystring or nullOptional<=255 characters

Optional client-supplied key. Duplicate events with the same key (scoped to the environment) are dropped for 24h.

sent_atdatetime or nullOptional
Optionally provide a timestamp at which the event was sent to Schematic
trusted_client_clockboolean or nullOptional

Requires a secret API key and sent_at. Use sent_at as the effective timestamp.

Response

Created
dataobject
paramsobject
Input parameters

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error