Skip to main content
POST
JavaScript

Authorizations

Authorization
string
header
required

Bearer token via Authorization header

Path Parameters

triggerId
string<uuid>
required

Body

application/json
payload
object
required

Arbitrary JSON object forwarded to every flow attached to this trigger. Validated against the trigger's customPayloadSchema when one is configured; otherwise only "must be a JSON object" is enforced.

invocationId
string<uuid>

Optional client-supplied idempotency key. When provided, a flow that already has an execution for this (flow, invocationId) is skipped and deduplicated is true. When omitted a fresh server-side id is generated (no dedup).

Response

Custom trigger fired; one execution enqueued per enabled flow attached to this trigger

deduplicated
boolean
required

True when at least one attached flow was skipped because it already had an execution for this (flow, invocationId). Only ever true when the client supplied invocationId.

enqueuedCount
integer
required

Number of flow executions enqueued. May be 0 if no flows are attached to this trigger, if all attached flows are currently in cooldown, or if every attached flow was deduplicated.

Required range: x >= 0
invocationId
string<uuid>
required

Unique ID for this fire invocation (echoes the client-supplied invocationId, or a generated one). Job IDs in the execution queue are derived from it (one per enqueued flow).