Menu
Amazon Simple Email Service
Developer Guide

Configuring Amazon SNS Notifications for Amazon SES

Amazon SES can notify you of your bounces, complaints, and deliveries through Amazon Simple Notification Service (Amazon SNS).

Important

For several important points about notifications, see Monitoring Using Amazon SES Notifications.

You can configure notifications by using the Amazon SES console or by using the Amazon SES API, as described in the following sections.

Configuring Notifications Using the Amazon SES Console

To configure notifications using the Amazon SES console

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

  2. In the navigation pane, under Identity Management, choose Domains or Email Addresses.

  3. In the list of verified senders, choose the email address or domain for which you want to configure notifications.

    Important

    Verified domain notification settings apply to all mail sent from email addresses in that domain except for email addresses that are also verified.

  4. In the details pane of the verified sender, expand Notifications.

  5. Choose Edit Configuration.

  6. Under SNS Topic Configuration, you can edit the Amazon SNS topic configuration as follows:

    1. Choose the Amazon SNS topics you want to use for bounces, complaints, and/or deliveries. You can choose to publish notifications to the same Amazon SNS topic or to different Amazon SNS topics.

      Important

      The Amazon SNS topics you use for bounce, complaint, and delivery notifications must be within the same AWS region in which you are using Amazon SES.

      If you want to use an Amazon SNS topic that you do not own, you must configure your AWS Identity and Access Management (IAM) policy to allow publishing from the Amazon Resource Name (ARN) of the Amazon SNS topic.

    2. If you want the Amazon SNS notifications to contain the original headers of the emails you pass to Amazon SES, choose Include original headers. This option is only available if you have assigned an Amazon SNS topic to the associated notification type. For information about the contents of the original email headers, see the mail object in Amazon SNS Notification Contents.

  7. If you choose Amazon SNS topics for both bounces and complaints, you can disable email notifications entirely. To disable email notifications for bounces and complaints, under Email Feedback Forwarding, choose Disable. Delivery notifications are available only through Amazon SNS.

  8. Choose Save Config. The changes you made to your notification settings might take a few minutes to take effect.

After you configure your settings, you will start receiving bounce, complaint, and/or delivery notifications to your Amazon SNS topic(s). These notifications will be in JavaScript Object Notation (JSON) format and will follow the structure described in Amazon SNS Notification Contents.

You will be charged standard Amazon SNS rates for bounce, complaint, and delivery notifications. For more information, see the Amazon SNS pricing page.

Note

If an attempt to publish to your Amazon SNS topic fails because the topic has been deleted or your AWS account no longer has permissions to publish to it, the Amazon SES configuration for that topic for the sending identity will be deleted, bounce and complaint notifications through email will be re-enabled for that identity, and you will be notified of the change through email. If you have multiple identities configured to use that topic, each identity will have its topic configuration changed when each identity experiences a failure to publish to that topic.

Configuring Notifications Using the Amazon SES API

You can also configure bounce, complaint, and delivery notifications with the Amazon SES API. The following actions are available:

  • SetIdentityNotificationTopic

  • SetIdentityFeedbackForwardingEnabled

  • GetIdentityNotificationAttributes

  • SetIdentityHeadersInNotificationsEnabled

You can use these API actions to write a customized front-end application for notifications. For a complete description of the API actions related to notifications, see the Amazon Simple Email Service API Reference.