Fire a trigger
Fires the trigger: validates payload against the trigger’s payloadSchema, upserts the contact derived from the payload, and starts one run per published automation attached to the trigger. Read details.automationRunIds[] and follow each via GET /v1/automations/runs?automationRunId=.
Idempotency — send a stable Idempotency-Key header on every retry (the body field idempotencyKey is a legacy alternative). Replays return the original run ids with status: "idempotent_replay" instead of starting duplicates.
Response-shape note — this endpoint responds with the legacy fire envelope { success, status, code, message, receivedAt, details } (shared with internal webhook infrastructure) rather than a bare resource. It is the ONE exception to the v1 response conventions; treat status + code as the discriminators.
Authorizations
Send your Brew API key as Authorization: Bearer brew_xxx.
Headers
Optional idempotency key for safe retries. Reusing the same key with the same request body returns the original response for 24 hours.
1 - 100Path Parameters
Trigger id returned by POST /v1/automations/triggers. Custom triggers use tri_… ids; integration triggers use composite ids (e.g. clerk:org_…:brand_…:user.created, URL-encode the colons).
1 - 256"tri_signup"
Body
Event payload — fields and types must match the trigger's payloadSchema. Unknown fields are accepted but reported as unexpected_key warnings.
Legacy body-field alternative to the Idempotency-Key HTTP header. Prefer the header for new integrations. The token is namespaced server-side with the API key org so different tenants cannot collide.
1 - 100Response
Fired (status: "triggered") or idempotent replay (status: "idempotent_replay"). details.automationRunIds[] carries one run id per matched published automation.
Discriminator for the response category. Pairs with code. A trigger with no published automation attached returns status: "failed" + code: "NO_PUBLISHED_AUTOMATION" (HTTP 422). Successful fires always return status: "triggered".
triggered, idempotent_replay, ready, invalid_api_key, invalid_json, failed, forbidden, payload_mismatch, trigger_event_not_found ISO-8601 timestamp the request was processed at.