Webhooks
Add an HTTPS endpoint under Webhooks. Choose the events you want. A signing secret (whsec_…) is shown once.
Payload
{
"id": "evt_0193…",
"type": "email.bounced",
"created_at": "2026-11-19T10:00:00Z",
"data": {
"email_id": "msg_0193…",
"recipient": "a@example.com",
"from": "hello@acme.com",
"subject": "Welcome",
"tags": {"category": "welcome"},
"bounce": {"type": "Permanent", "diagnostic": "smtp; 550 5.1.1 user unknown"}
}
}
Headers
MailerOwl-Id: evt_0193…
MailerOwl-Timestamp: 1763546400
MailerOwl-Signature: v1=<hex>
The signature is HMAC-SHA256(secret, "{timestamp}.{raw_body}") in hex. See Verify signatures.
Delivery and retries
Return any 2xx within 10 seconds. Otherwise we retry 8 times over about 24 hours (30 s, 2 m, 10 m, 30 m, 1 h, 6 h, 16 h). Events can arrive out of order and more than once: de-duplicate on id. Endpoints that fail permanently 50 times in a row are disabled and owners are emailed. See every attempt in the delivery log and press Resend.
Destinations that resolve to private or loopback addresses are blocked.