How can I remove email addresses that are on an Amazon SES suppression list?

Last updated: 2022-02-04

I want to remove email addresses that are on the Amazon Simple Email Service (Amazon SES) global suppression list or an account-level suppression list. Can I automatically remove email addresses from an Amazon SES suppression list?

Resolution

Removal from account-level suppression list

Sending a message to an email address can sometimes result in hard bounces, complaints, or both. To avoid hard bounces, you can configure an account-level suppression list to add that email address. An account-level suppression list applies to an AWS account in a specific AWS Region.

It's a best practice to not automatically remove email addresses from account-level suppression lists. Instead, first validate the email address and the associated bounces or complaints. Then, if you determine that the email address should receive messages, remove the email address from the suppression list. You can remove an email address using either the AWS Command Line Interface (AWS CLI) or the AWS CloudShell console.

For more information on using an account-level suppression list, see Account-level suppression list considerations.

Note: If your Amazon SES account's ability to send email is paused, then Amazon SES deletes the addresses in your account-level suppression list after 90 days. If your account's ability to send email is restored within 90 days, then your account-level suppression list retains the addresses.

Use the AWS CLI

Note: If you receive errors when running AWS CLI commands, make sure that you’re using the most recent version of the AWS CLI.

To remove an email address from an account-level suppression list using the AWS CLI, follow these steps:

1.    Install the AWS CLI. Then, configure the AWS CLI with the AWS account and AWS Region associated with the account-level suppression list that you want to modify.

2.    Run the delete-suppressed-destination command on the email address that you want to remove from the email list:

$aws sesv2 delete-suppressed-destination --email-address user@example.com

For more information, see Removing an email address from the account-level suppression list.

Use the CloudShell console

To remove an email address from an account-level suppression list using the CloudShell console, follow these steps:

1.    Open the CloudShell console. You can also access the CloudShell console from anywhere in the AWS Management Console by choosing the CloudShell icon on the top toolbar.

Note: Your AWS Identity and Access Management (IAM) role must include permissions to change or modify an Amazon SES account-level suppression list.

2.    Run the following command to verify the IAM role:

$ aws sts get-caller-identity

3.    Run the following command to remove an email address from the account-level suppression list:

aws sesv2 delete-suppressed-destination  --email-address user@example.com

Removal from the global suppression list

Amazon SES adds an email address to the global suppression list if any Amazon SES message to the address results in a hard bounce.

When an email address produces a hard bounce, Amazon SES adds the address to the global suppression list for a short period of time. If the email address produces another hard bounce, it's added to the global suppression list for a longer period of time. An email address can remain on the global suppression list for up to 14 days.

The global suppression list is activated by default for all Amazon SES accounts and can't be turned off.

For more information on using the global suppression list, see Global suppression list considerations.