Test Mailgun webhooks
Mailgun sends webhooks for email delivery, failures, opens, clicks, and unsubscribes. Capture them on a free webhooks.cc endpoint to see exactly what Mailgun sends — or fire realistic, correctly signed sample payloads at your own handler without touching a production account.
No credit card · 50 requests/day free · or get a guest URL without an account
Prefer a walkthrough? Read the local webhook testing guide.
How to test Mailgun webhooks
- 1
Create a webhook endpoint
Sign in free with GitHub or Google to create a persistent endpoint — or grab an instant guest URL at webhooks.cc/go without an account.
- 2
Point Mailgun at your URL
Paste the endpoint URL into Mailgun: Mailgun → Sending → Webhooks.
- 3
Inspect what arrives
Each delivery appears live in the dashboard with method, headers, body, query parameters, and source IP.
- 4
Forward to localhost or assert in CI
Run whk tunnel <port> to forward webhooks to a local server, or use the TypeScript SDK to wait for and assert on deliveries in tests.
Mailgun webhook signature
| Algorithm | HMAC-SHA256 |
|---|---|
| Verification in webhooks.cc | Supported — add your signing secret and every request is checked automatically |
Mailgun does not use a conventional signature header. Capture a real delivery to inspect exactly what is sent.
New to signature verification? Read the webhook signature verification guide.
Send sample Mailgun events
These Mailgun templates ship with realistic payloads and valid signature headers. Send them from the dashboard's Send button, the SDK, or your AI agent via MCP.
deliveredfailedopened# Send a signed Mailgun sample with the SDK
await client.endpoints.sendTemplate( slug, {
provider: "mailgun",
template: "delivered",
secret: "your-test-secret",
});Everything in one place
- Live dashboard — see deliveries the moment they arrive
- Forward to localhost with whk tunnel
- Replay any captured request to any URL
- Mock responses with custom status, headers, and body
- TypeScript SDK assertions for CI
- MCP server for AI coding agents
Mailgun webhook questions
More providers
Your Mailgun webhook URL is seconds away
Sign up free, create an endpoint, and point Mailgun at it.
No credit card · or try without an account