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

Last updated: 2021-06-21

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 this, 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.

For macOS or Linux:

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

For Windows:

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

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 quickly 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 when any Amazon SES message to the address results in a hard bounce. The global suppression list is turned on by default for all accounts.

Amazon SES automatically removes email addresses from the global suppression list after 14 days. If an email address on the global suppression list should receive messages, follow these steps to manually remove the email address from the list:

1.    Open the Amazon SES console.

2.    On the top navigation bar, review the Region selector and confirm that you're in US East (N. Virginia), US West (Oregon), or Europe (Ireland). You can modify the global suppression list from any of these three Regions, but not from any other Region.

3.    From the left navigation pane, choose Suppression List Removal.

4.    For Email Address, enter the email address that you want to remove from the global suppression list.

5.    For Type characters, enter the characters that you see in the image.

6.    Choose Submit.

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