SES / Client / set_identity_feedback_forwarding_enabled

set_identity_feedback_forwarding_enabled#

SES.Client.set_identity_feedback_forwarding_enabled(**kwargs)#

Given an identity (an email address or a domain), enables or disables whether Amazon SES forwards bounce and complaint notifications as email. Feedback forwarding can only be disabled when Amazon Simple Notification Service (Amazon SNS) topics are specified for both bounces and complaints.

Note

Feedback forwarding does not apply to delivery notifications. Delivery notifications are only available through Amazon SNS.

You can execute this operation no more than once per second.

For more information about using notifications with Amazon SES, see the Amazon SES Developer Guide.

See also: AWS API Documentation

Request Syntax

response = client.set_identity_feedback_forwarding_enabled(
    Identity='string',
    ForwardingEnabled=True|False
)
Parameters:
  • Identity (string) –

    [REQUIRED]

    The identity for which to set bounce and complaint notification forwarding. Examples: user@example.com, example.com.

  • ForwardingEnabled (boolean) –

    [REQUIRED]

    Sets whether Amazon SES forwards bounce and complaint notifications as email. true specifies that Amazon SES forwards bounce and complaint notifications as email, in addition to any Amazon SNS topic publishing otherwise specified. false specifies that Amazon SES publishes bounce and complaint notifications only through Amazon SNS. This value can only be set to false when Amazon SNS topics are set for both Bounce and Complaint notification types.

Return type:

dict

Returns:

Response Syntax

{}

Response Structure

  • (dict) –

    An empty element returned on a successful request.

Examples

The following example configures Amazon SES to forward an identity’s bounces and complaints via email:

response = client.set_identity_feedback_forwarding_enabled(
    ForwardingEnabled=True,
    Identity='user@example.com',
)

print(response)

Expected Output:

{
    'ResponseMetadata': {
        '...': '...',
    },
}