All Providers
πŸ”«

Mailgun Webhooks

Communications

Mailgun sends webhooks for email delivery status, opens, clicks, bounces, and spam complaints. Used by developers who send transactional email via the Mailgun API.

Webhook Events

5 event types

delivered

Email was accepted by recipient server

opened

Recipient opened the email

clicked

Recipient clicked a link

bounced

Email hard bounced

complained

Spam complaint received

Signature Verification

Header
X-Mailgun-Signature-V2
Method

HMAC-SHA256 of timestamp + token using API key

View official docs

Sample Payload

delivered

application/json
{
  "signature": {
    "timestamp": "1712000000",
    "token": "abc123token",
    "signature": "hmac_sig_here"
  },
  "event-data": {
    "event": "delivered",
    "timestamp": 1712000000,
    "recipient": "[email protected]",
    "message": {
      "headers": {
        "message-id": "[email protected]"
      }
    }
  }
}

Send a Sample Mailgun Payload

Pick an event, enter your endpoint URL (or localhost), and fire a realistic Mailgun payload with one click β€” no Mailgun account needed.

Test Sender

Loading samples…

No signup

Capture & Inspect Mailgun Webhooks Live

Get a free public HTTPS endpoint below, point Mailgun at it, and watch events arrive in real time. Use the forwarding rule to relay them straight to your local server.

Live demo β€” no signup required

See it work in real time

Click below to get a live webhook URL instantly. Paste it anywhere β€” Stripe, GitHub, Postman β€” and watch events arrive right here.

Expires in 1 hour Β· No account needed

Forward Mailgun webhooks to localhost

  1. Click Create live endpoint above to get a public HTTPS URL
  2. Paste the URL into Mailgun's webhook settings
  3. In the Forwarding tab, add a rule: target = http://localhost:3000/webhooks/mailgun
  4. Fire a test event from Mailgun β€” it arrives in the inspector and hits your local handler simultaneously

Ready to test your Mailgun webhook handler?

Free HTTPS endpoint with forwarding, retry, and event replay. No install, no CLI, no deploy.

Create Free Account