Mailgun Webhooks
CommunicationsMailgun 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
deliveredEmail was accepted by recipient server
openedRecipient opened the email
clickedRecipient clicked a link
bouncedEmail hard bounced
complainedSpam complaint received
Signature Verification
X-Mailgun-Signature-V2HMAC-SHA256 of timestamp + token using API key
Sample Payload
delivered
{
"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β¦
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.
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
- Click Create live endpoint above to get a public HTTPS URL
- Paste the URL into Mailgun's webhook settings
- In the Forwarding tab, add a rule: target =
http://localhost:3000/webhooks/mailgun - 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