Fire Custom Event
Fire a custom developer/integration trigger event.
Writes an EventOutbox row (status pending) that the relay worker
will pick up and match against active automation triggers.
idempotency_key (REQUIRED) — the event is deduplicated per-team.
A repeat call with the same key for the same team returns 200 without
writing a new row. Different teams with the same key are NOT suppressed.
Returns 202 on a new event, 200 on a duplicate.
Errors flow through the central error pipeline (jsonapi_error).
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Response
Successful Response
Top-level meta-only response for POST /automations/events.
JSON:API allows a top-level meta without data for non-resource
responses (§ 7.1 "Top Level"). This is used for the custom-event fire
endpoint which writes an outbox row but does not return a resource.
meta payload for the POST /automations/events response.
Returned on both 202 (new event) and 200 (duplicate/deduped) responses.
accepted is True when the event was newly written; False when
the idempotency_key was already present (dedup).