Webhooks

Webhooks send events for emails you sent with the API to a URL you choose. You don’t need to poll. Each workspace has its own webhook URL, which receives every event type for emails sent from that workspace’s domains. One API key can send from any of your workspaces, and each event goes to the webhook of the workspace the email was sent from.

Events

Event	Sent when
`sent`	The recipient’s mail server accepts the email. A bounce can still follow.
`failed`	An email that was queued (`202`, `status: "scheduled"`) couldn’t be sent when its send slot came. `message_id` is null.
`open`	The recipient opens an email that has `open_tracking` enabled. Sent for every open, not just the first.
`click`	The recipient clicks a link in an email that has `click_tracking` enabled.
`bounce`	The recipient’s mail server rejects the email. The address is added to your suppression list.
`unsubscribe`	The recipient unsubscribes using their mail client’s unsubscribe button. The address is added to your suppression list.
`reply`	A reply arrives in a conversation you started with Send Email.

Automated opens and clicks by mail security scanners are filtered out. Sample payloads for each event are listed under Webhook Events in the sidebar.

Set up your webhook

In the dashboard, switch to the workspace that owns your sending domain, go to Integrations, open Deliveryman API Keys and click Manage.
Under Webhook Events, enter your endpoint URL and click Save webhook. The URL must use https:// and be publicly reachable.

From the same page you can pause events or remove the webhook. Events that happen while the webhook is paused are not delivered later.

Event format

Every event is a POST request with a JSON body. All events share the same envelope:

{
  "id": "evt_4f0c1b2a9d8e4c7b8a6f5e4d3c2b1a09",
  "type": "click",
  "created": "2026-09-17T10:14:28Z",
  "data": {
    "message_id": "em_9f2c4a7b1e0d3c5a8b6f4e21",
    "from": "jane@draftss.com",
    "to": "alex@draftss.com",
    "subject": "Quick question about your onboarding flow",
    "sent_on": "2026-09-17T10:00:00Z",
    "link": "https://draftss.com/pricing",
    "clicked_on": "2026-09-17T10:14:27Z"
  }
}

id is unique per event. Use it to ignore duplicate deliveries.
type is the event type.
data.message_id matches the message_id returned by Send Email.
The other data fields depend on the event type.

Respond and retries

Respond with any 2xx status within 10 seconds. Do slow work, like calling other APIs, after you respond. If your endpoint returns another status, times out or can’t be reached, the event is retried 3 more times: after 1, 5 and 15 minutes. Redirects are not followed, so use the final URL. Events can occasionally arrive more than once or out of order. Use id to ignore duplicates, and the timestamps in data to order them. If you miss an event, Retrieve Sent Email returns the email’s current status, opens, clicks, bounce and replies.

Get started

Endpoints

Events

Set up your webhook

Event format

Respond and retries

​Events

​Set up your webhook

​Event format

​Respond and retries

Events

Set up your webhook

Event format

Respond and retries