Amazon Simple Email Service
Developer Guide

Amazon SES Notifications Through Email

Amazon SES can send you email when you receive bounces and complaints by using a process called email feedback forwarding.

In order to send email using Amazon SES, you must configure it to send bounce and complaint notifications by using one of the following methods:

Important

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

Enabling Email Feedback Forwarding

Email feedback forwarding is enabled by default. If you previously disabled it, you can enable it by following the procedures in this section.

To enable bounce and complaint forwarding through email 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 Email Addresses if you want to configure bounce and complaint notifications for an email address, or choose Domains if you want to configure bounce and complaint notifications for a domain.

  3. In the list of verified email addresses or domains, choose the email address or domain that you want to configure bounce and complaint notifications for.

  4. In the details pane, expand the Notifications section.

  5. Choose Edit Configuration.

  6. Under Email Feedback Forwarding, choose Enabled.

    Note

    Changes you make on this page may take a few minutes to take effect.

You can also enable bounce and complaint notifications through email by using the SetIdentityFeedbackForwardingEnabled API operation.

Disabling Email Feedback Forwarding

If you set up a different method of providing bounce and complaint notifications, you can disable email feedback forwarding so that you don't receive multiple notifications when a bounce or complaint event occurs.

To disable bounce and complaint forwarding through email 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 Email Addresses if you want to configure bounce and complaint notifications for an email address, or choose Domains if you want to configure bounce and complaint notifications for a domain.

  3. In the list of verified email addresses or domains, choose the email address or domain that you want to configure bounce and complaint notifications for.

  4. In the details pane, expand the Notifications section.

  5. Choose Edit Configuration.

  6. Under Email Feedback Forwarding, choose Disabled.

    Note

    You must configure one method of receiving bounce and complaint notifications in order to send email through Amazon SES. If you disable email feedback forwarding, you must enable notifications sent by Amazon SNS, or publish bounce and complaint events to an Amazon SNS topic or a Kinesis Data Firehose stream by using event publishing. If you use event publishing, you must also apply the configuration set that contains the event publishing rule to each email you send. If you don't set up a method of receiving bounce and complaint notifications, Amazon SES automatically forwards feedback notifications by email to the address in the Return-Path field (or the Source field, if you didn't specify a Return-Path address) of the message that resulted in the bounce or complaint event. In this situation, Amazon SES forwards bounce and complaint notifications even if you disabled email feedback notifications.

  7. Choose Save Config to save your notification configuration.

    Note

    Changes you make on this page might take a few minutes to take effect.

You can also disable bounce and complaint notifications through email by using the SetIdentityFeedbackForwardingEnabled API operation.

Email Feedback Forwarding Destination

When you receive notifications by email, Amazon SES rewrites the From header and sends the notification to you. The address to which Amazon SES forwards the notification depends on how you sent the original message.

If you used the SMTP interface to send the message, then notifications go to the address specified in the MAIL FROM command, which overrides any Return-Path headers specified in the SMTP DATA.

If you used the SendEmail API operation to send the message, then the notifications are delivered as follows:

  • If you specified the optional ReturnPath parameter of SendEmail, then notifications go to that address.

  • Otherwise, notifications go to the address specified in the required Source parameter of SendEmail, which populates the From header of the message.

If you used the SendRawEmail API operation to send the message, then the notifications are delivered as follows:

  • If you specified the optional Source parameter of SendRawEmail, then notifications go to that address, overriding any Return-Path headers specified in the raw message.

  • Otherwise, if the Return-Path header was specified in the raw message, then notifications go to that address.

  • Otherwise, notifications go to the address in the From header of the raw message.

Important

Regardless of whether you use the SMTP interface, SendEmail API, or SendRawEmail API, Amazon SES overwrites any Return-Path headers that you provide.