Email Bounce Monitoring for Mailgun
Track Mailgun email delivery in real-time. Monitor bounces, complaints, and failures with automated suppression lists to protect your sender reputation.
Mailgun Integration Features
Supported Mailgun Events
| Mailgun Event | ParseBounce Type | Description | Suppression |
|---|---|---|---|
| failed (permanent) | bounce | Permanent delivery failure - invalid email address | Auto |
| failed (temporary) | deferred | Temporary delivery failure - will retry | — |
| complained | complaint | Recipient marked email as spam | Auto |
| delivered | delivery | Email successfully delivered | — |
| opened | open | Recipient opened the email | — |
| clicked | click | Recipient clicked a link | — |
| unsubscribed | unsubscribe | Recipient unsubscribed from emails | Auto |
Events marked "Auto" are automatically added to your suppression list
How to Set Up Mailgun
Follow these steps to start monitoring your Mailgun emails
Go to Mailgun Webhooks Settings
Log in to Mailgun → Sending → Webhooks. Select the domain you want to monitor.
Add ParseBounce Webhook URL
Copy your unique Mailgun webhook URL from ParseBounce settings and add it for each event type you want to track.
Configure Event Types
Enable webhooks for: Permanent Failures, Temporary Failures, Complaints, Delivered, Opens, Clicks, and Unsubscribes.
Copy Webhook Signing Key
Go to Settings → API Security → Webhook signing key. Copy this key and add it to your ParseBounce project settings.
Test the Connection
Send a test email and verify events appear in your ParseBounce dashboard.
Frequently Asked Questions
Do I need the webhook signing key?
Yes, the signing key is required for ParseBounce to verify webhook authenticity. Without it, webhooks will be rejected for security reasons.
What's the difference between permanent and temporary failures?
Permanent failures (hard bounces) indicate invalid email addresses and should be removed from your list. Temporary failures are transient issues like full mailboxes that Mailgun will retry automatically.
Can I track custom variables?
Yes! Add X-Mailgun-Variables header with JSON data including parsebounce_id to track custom campaign IDs or batch identifiers.
How do I monitor multiple domains?
You can configure webhooks for each domain in Mailgun. Point them all to the same ParseBounce webhook URL for unified monitoring.
