v36

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0187270483.0 KB

Webhooks

Send event

Delivered when a send function attempts to deliver a payload to a downstream destination (webhook, S3, or Google Drive). The result of that delivery — including the destination's response — is in the body. The original payload that was delivered is mirrored in deliveredContent.

For signing-secret setup and retry semantics that apply to every variant, see the Webhooks overview.

postWebhooksend

Payload

functionCallTryNumberinteger

The attempt number of the function call that created this event. 1 indexed.

eventIDstring required

Unique ID generated by bem to identify the event.

createdAtstring date-time

Timestamp indicating when the event was created.

referenceIDstring required

The unique ID you use internally to refer to this data point, propagated from the original function input.

eventType'send'

functionCallIDstring

Unique identifier of function call that this event is associated with.

functionIDstring required

Unique identifier of function that this event is associated with.

functionNamestring required

Unique name of function that this event is associated with.

functionVersionNuminteger

Version number of function that this event is associated with.

callIDstring

Unique identifier of workflow call that this event is associated with.

workflowIDstring

Unique identifier of workflow that this event is associated with.

workflowNamestring

Name of workflow that this event is associated with.

workflowVersionNuminteger

Version number of workflow that this event is associated with.

deliveryStatus'success' | 'skip' required

Outcome of a Send function's delivery attempt.

destinationType'webhook' | 's3' | 'google_drive' required

Destination type for a Send function.

deliveredContentobject

The full protocol event JSON that was delivered — identical to what subscription publish would deliver for the same event. For ad-hoc calls with a JSON file input, contains the raw input JSON. For ad-hoc calls with a binary file input, contains {"s3URL": "<presigned-url>"}.

Response

Return any 2XX status code to acknowledge receipt. The exact code is not inspected.