Skip to main content
POST
Send a signed module event

Authorizations

Authorization
string
header
required

Module ingest credential (mk_live_...) sent as Authorization: Bearer <key>.

Headers

X-4D-Signature
string
required

Signature in the form t=<unix_seconds>,v1=<hex_hmac>.

Idempotency-Key
string
required

Must equal the body event_id; reuse it only with the same event body.

Minimum string length: 1

Body

application/json
type
string
required

Module-owned native event type

Minimum string length: 1
version
integer
required

Version of the native event type

Required range: x >= 1
event_id
string
required

Caller-generated idempotency identifier

Minimum string length: 1
occurred_at
string<date-time>
required
payload
object
required

Payload validated by the installed module manifest

member_external_id
string
Minimum string length: 1

Response

Event recorded with a canonicalised, rejected, or mapping_failed outcome

inbound_event_id
string
required
status
enum<string>
required
Available options:
received,
validated,
canonicalised,
rejected,
mapping_failed
canonical_event_id
string | null
required
reject_reason
string | null
required