Email Bounce & Complaint Monitoring for AWS SES
Get real-time visibility into your AWS SES email delivery. Track bounces, complaints, and delivery issues before they impact your sender reputation.
AWS SES Integration Features
Supported AWS SES Events
| AWS SES Event | ParseBounce Type | Description | Suppression |
|---|---|---|---|
| Bounce (Hard) | bounce | Permanent delivery failure - invalid email address | Auto |
| Bounce (Soft) | bounce | Temporary delivery failure - mailbox full, server unavailable | — |
| Complaint | complaint | Recipient marked email as spam | Auto |
| Delivery | delivery | Email successfully delivered to recipient server | — |
| Reject | reject | SES rejected the email before sending | — |
| Open | open | Recipient opened the email | — |
| Click | click | Recipient clicked a link in the email | — |
Events marked "Auto" are automatically added to your suppression list
How to Set Up AWS SES
Follow these steps to start monitoring your AWS SES emails
Create a Configuration Set in SES
Go to AWS SES Console → Configuration Sets → Create a new set. This groups your sending settings and event destinations.
Add SNS Event Destination
In your Configuration Set, add an event destination. Select SNS as the destination type and create a new SNS Topic.
Subscribe ParseBounce Webhook
Copy your unique webhook URL from ParseBounce settings and add it as an HTTPS subscription to your SNS Topic.
Confirm Subscription
ParseBounce will automatically confirm the SNS subscription. Your project status will change to "Active".
Use Configuration Set When Sending
Add the X-SES-CONFIGURATION-SET header to your emails or specify it in your SES API calls.
Frequently Asked Questions
Do I need a Configuration Set?
Yes, Configuration Sets are required to receive event notifications from SES. They allow you to specify where SES should send delivery events.
What are the SES bounce rate limits?
AWS SES recommends keeping your bounce rate below 5% and complaint rate below 0.1%. Exceeding these limits can result in your account being put on probation or suspended.
How do I handle soft bounces?
Soft bounces are temporary failures. ParseBounce tracks them but doesn't automatically suppress these addresses. Consider retrying delivery after some time, but monitor for repeated soft bounces.
Can I use multiple Configuration Sets?
Yes, you can have multiple Configuration Sets in SES, but each should point to the same ParseBounce webhook URL for your project.
