How can I set up Amazon SES bounce notifications using an Amazon SNS topic?

Last updated: 2020-04-28

I want to get notifications whenever emails that I send using Amazon Simple Email Service (Amazon SES) result in a bounce. How can I set up these notifications using Amazon Simple Notification Service (Amazon SNS)?

Resolution

Before you begin, complete the Amazon SES verification process for the identity (domain or email address) that you want to get bounce notifications for.

Create a topic and subscription in Amazon SNS

  1. Open the Amazon SNS console.
  2. Choose Create topic.
  3. For Topic name, enter a name to create a unique identifier for your topic.
  4. For Display name, enter a display name for your topic.
  5. Choose Create topic.
  6. From the Topic details of the topic that you created, navigate to Subscriptions, and then choose Create subscription.
  7. For Protocol, select Email-JSON.
  8. For Endpoint, enter the email address where you want to receive notifications.
  9. Choose Create subscription.
  10. From the inbox of the email address that you specified in step 8, open the subscription confirmation email from Amazon SNS with the subject line AWS Notification - Subscription Confirmation.
  11. In the subscription confirmation email, open the URL specified as SubscribeURL to confirm your subscription.

Configure Amazon SES to send bounce information to Amazon SNS

  1. Open the Amazon SES console.
  2. In the navigation pane, choose Domains or Email Addresses. Then, select the verified domain or email address that you want to get bounce notifications for.
  3. Expand Notifications, and then choose Edit Configuration.
  4. Under SNS Topic Configuration, for Bounces, select the SNS topic that you created.
    Note: You can choose to also enable notifications for Complaints and Deliveries. You can publish multiple event types to the same SNS topic or to different SNS topics.
  5. Select Include original headers if you want the Amazon SNS notifications to contain the original headers of the emails that you send using Amazon SES.
  6. Choose Save Config.
    Note: It might take a few minutes for your newly configured notification settings to take effect.

Test the bounce notifications using the Amazon SES mailbox simulator

Note: The bounces from the mailbox simulator address aren't counted as part of your account's bounce metrics.

  1. Open the Amazon SES console.
  2. In the navigation pane, choose Domains or Email Addresses. Then, select the verified domain or email address that you want to set up bounce notifications for.
  3. Choose Send a Test Email.
  4. In the test email form, for the To field, enter bounce@simulator.amazonses.com. Then, complete the rest of the form with the values that you want for the test email.
  5. Choose Send Test Email.
  6. Open the inbox for the email address that you set as the endpoint of the SNS topic. Confirm that you have an email with the subject line AWS Notification Message that contains the bounce notification.


Did this article help you?

Anything we could improve?


Need more help?