---
title: "Send event"
method: POST
path: "send"
tags: ["Webhooks"]
---

# Send event

`POST send` (webhook)

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](/api/v3/webhooks).

## Payload

- SendEvent
  - `functionCallTryNumber` integer — The attempt number of the function call that created this event. 1 indexed.
  - `eventID` string, required — Unique ID generated by bem to identify the event.
  - `createdAt` string, date-time — Timestamp indicating when the event was created.
  - `referenceID` string, required — The unique ID you use internally to refer to this data point, propagated from the original function input.
  - `inboundEmail` EventInboundEmail
    - `to` string, required — The email address of the recipient.
    - `deliveredTo` string — The email address of the original intended recipient if the email itself was forwarded.
    - `from` string, required — The email address of the sender.
    - `subject` string, required — The subject of the email.
  - `metadata` object
    - `durationFunctionToEventSeconds` number
  - `eventType` 'send'
  - `functionCallID` string — Unique identifier of function call that this event is associated with.
  - `functionID` string, required — Unique identifier of function that this event is associated with.
  - `functionName` string, required — Unique name of function that this event is associated with.
  - `functionVersionNum` integer — Version number of function that this event is associated with.
  - `callID` string — Unique identifier of workflow call that this event is associated with.
  - `workflowID` string — Unique identifier of workflow that this event is associated with.
  - `workflowName` string — Name of workflow that this event is associated with.
  - `workflowVersionNum` integer — 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.
  - `deliveredContent` object — 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>"}.
  - `webhookOutput` SendEventWebhookOutput — Metadata returned when a Send function delivers to a webhook.
    - `httpStatusCode` integer, required — HTTP status code returned by the webhook endpoint.
    - `httpResponseBody` string, required — Raw HTTP response body returned by the webhook endpoint.
  - `s3Output` SendEventS3Output — Metadata returned when a Send function delivers to an S3 bucket.
    - `bucketName` string, required — Name of the S3 bucket the payload was written to.
    - `key` string, required — Object key under which the payload was stored.
  - `googleDriveOutput` SendEventGoogleDriveOutput — Metadata returned when a Send function delivers to Google Drive.
    - `folderID` string, required — ID of the Google Drive folder the file was placed in.
    - `fileName` string, required — Name of the file created in Google Drive.

## Acknowledgement `2XX`

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

---

[API](https://skmtc.dev/bem-team/apis/bem-api.md) · [All operations](https://skmtc.dev/bem-team/apis/bem-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bem-team/bem-api/revisions/a6e4624117c6/schema)