Skip to content
MailerOwl
Menu

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.