Skip to main content
PUT
Ingest an event with an ingest key (PUT alias of ingestEvent)

Authorizations

Authorization
string
header
required

An ik_live_… ingest key. Stored hashed; the plaintext is returned once at creation.

Headers

Idempotency-Key
string

Optional; a repeat key short-circuits with 200 before quota is charged.

X-Hookie-Signature
string

Required only when the key has require_signature. Format 't=,v1=', v1 = HMAC-SHA-256 over '.'.

Path Parameters

ingest_key
string
required

The plaintext ingest key (prefix lookup + constant-time SHA-256 comparison).

Body

Identical to POST /v1/ingest/{ingest_key}: form encodings are flattened, anything else is parsed as JSON, an empty body becomes {}, and bodies over 1,000,000 bytes are rejected with 413.

Any JSON value.

Response

Idempotent replay of a submission already stored under this Idempotency-Key.

submission_id
string
required
idempotent
enum<boolean>
required
Available options:
true