Mailfullydocs

Create a webhook endpoint

Register an http(s) endpoint to receive email events. The signingsecret (whsec…) is returned once, only here — store it to verify delivery signatures.

POSThttps://api.mailfully.com/v1/webhooks

Register an http(s) endpoint to receive email events. The signing_secret (whsec_…) is returned once, only here — store it to verify delivery signatures. Requires the manage:webhooks scope, which is a dashboard-session scope and cannot be granted to API keys today: every mf_ API key receives 403. Call this endpoint with a dashboard session token (owner, admin, or member).

Loading code example
Loading code example

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

urlstringrequired

Destination URL; must be an http(s) URL.

eventsarray<"email.delivered" | "email.bounced" | "email.complained" | "email.failed" | "email.delivery_delayed" | "email.opened" | "email.clicked" | "email.suppressed">required

The event types to subscribe to.

Required array length: >= 1 elements

Response

application/json

The webhook endpoint was created.