Email Bounce & Complaint Monitoring for SendGrid
Track every SendGrid email event in real-time. Monitor bounces, spam reports, and delivery status to maintain a healthy sender reputation.
SendGrid Integration Features
Supported SendGrid Events
| SendGrid Event | ParseBounce Type | Description | Suppression |
|---|---|---|---|
| bounce | bounce | Email bounced - hard or soft failure | Auto |
| dropped | reject | SendGrid dropped the email before sending | — |
| spamreport | complaint | Recipient reported email as spam | Auto |
| delivered | delivery | Email accepted by recipient server | — |
| deferred | deferred | Temporary delivery failure, will retry | — |
| open | open | Recipient opened the email | — |
| click | click | Recipient clicked a link | — |
| unsubscribe | unsubscribe | Recipient unsubscribed from emails | — |
Events marked "Auto" are automatically added to your suppression list
How to Set Up SendGrid
Follow these steps to start monitoring your SendGrid emails
Go to SendGrid Event Webhook Settings
Log in to SendGrid → Settings → Mail Settings → Event Webhook. Enable the Event Webhook feature.
Add ParseBounce Webhook URL
Copy your unique SendGrid webhook URL from ParseBounce settings and paste it in the HTTP Post URL field.
Select Events to Track
Check all the events you want to monitor: Bounces, Spam Reports, Delivered, Opens, Clicks, etc.
Enable Signed Webhook (Recommended)
Enable "Signed Event Webhook" for security. Copy the Verification Key and add it to your ParseBounce project settings.
Test the Connection
Click "Test Your Integration" in SendGrid to send a test event. Verify it appears in your ParseBounce dashboard.
Frequently Asked Questions
Do I need to enable Signed Webhooks?
While not required, we strongly recommend enabling Signed Webhooks. This ensures that events are actually coming from SendGrid and haven't been tampered with.
What is the "dropped" event?
A dropped event means SendGrid decided not to send the email. This can happen if the recipient is on your suppression list, the email is invalid, or content was flagged.
How are deferred events handled?
Deferred events indicate temporary delivery failures. SendGrid will automatically retry. ParseBounce tracks these so you can monitor delivery delays.
Can I use multiple webhook URLs?
SendGrid only supports one Event Webhook URL per account. If you need to send events to multiple places, consider using a webhook relay service.
