Menu
Amazon Simple Email Service
Developer Guide

Set Up an Amazon SNS Event Destination for Amazon SES Event Publishing

An Amazon Simple Notification Service event destination notifies you about specific email sending events using Amazon SNS. Because an Amazon SNS event destination exists within a configuration set only, you must first create a configuration set and then add the event destination to the configuration set.

You can use the Amazon SES console or the UpdateConfigurationSetEventDestination API operation to add an Amazon SNS event destination.

Note

It is also possible to receive notifications through Amazon SNS at the account level. This means that you can receive Amazon SNS notifications every time a sending event occurs across your entire Amazon SES account. By using event publishing rather than account-level notifications, you can configure Amazon SES to only send notifications about specific event types, or only for emails sent using a particular configuration set. For more information about setting up account-level Amazon SNS notifications, see Monitoring Using Amazon SES Notifications.

To add an Amazon SNS event destination to a configuration set

  1. Sign in to the AWS Management Console and open the Amazon SES console at https://console.aws.amazon.com/ses/.

  2. In the left navigation pane, choose Configuration Sets.

  3. Choose a configuration set from the configuration set list. If the list is empty, you must first create a configuration set.

  4. For Add Destination, choose Select a destination type, and then choose SNS.

  5. For Name, type a name for the event destination.

  6. For Event types, select at least one event type to publish to the event destination:

    • Send – Your API call to Amazon SES was successful and Amazon SES attempted to deliver the email.

    • Reject – Amazon SES initially accepted the email, but later rejected it because the email contained a virus.

    • Bounce – The recipient's mail server permanently rejected the email. This event corresponds to hard bounces. Soft bounces are only included when Amazon SES fails to deliver the email after retrying for a period of time.

    • Complaint – The recipient marked the email as spam.

    • Delivery – Amazon SES successfully delivered the email to the recipient's mail server.

    • Open – The recipient received the message and opened it in his or her email client.

    • Click – The recipient clicked one or more links contained in the email.

  7. Select Enabled.

  8. For Topic, choose an existing Amazon SNS topic, or choose Create new topic to create a new one.

    For information about creating a topic, see "Create a Topic" in the Amazon Simple Notification Service Developer Guide.

  9. Choose Save.

  10. To exit the Edit Configuration Set page, use the back button of your browser.