Create a signed, retried destination or idempotent inbound event source.

post/v1/workspaces/{workspaceId}/webhooks

Request

  • Base URL: https://api.bangermail.com
  • URL: https://api.bangermail.com/v1/workspaces/{workspaceId}/webhooks
  • Auth: HTTP bearer

Request body

kind'outbound' | 'inbound' required
namestring required
source_keystring

banger_api is reserved for the webhook POST /events creates.

signing_secretstring

Supabase Send Email Hook secret. Accepted only for an inbound Supabase source and encrypted at rest.

endpoint_urlstring uri

Required for outbound destinations only.

event_typesstring[]

Events to send. Omitted, an outbound endpoint gets the default activity events; the specific events (mail.received, mail.sent, send., journey.) are sent only when listed. * sends everything, including the high-volume send.delivered.

Response

Webhook created. Outbound signing secrets are shown once; inbound credential options can be reopened by authorized callers.

Changes

No recorded changes to this operation across all 2 revisions of this API.