Managing a custom suppression list
A custom suppression list contains recipient addresses to whom Yandex Cloud Postbox does not send emails if the reason for adding the address blocks delivery. The list is created for a cloud and is common to all folders, addresses, and configurations within it.
To view the stop list, you need the postbox.viewer role. To add and delete addresses, you need the postbox.editor role.
To ensure that Yandex Cloud Postbox checks the custom suppression list when sending emails, configure the suppression list settings in the configuration.
Adding a recipient's address to the suppression list
- Navigate to Cloud Postbox.
- In the left-hand panel, select Suppression list.
- Click Add.
- In the Email address field, enter the recipient's address you want to add to the custom suppression list.
- In the Reason field, select a reason why the recipient's address should be added to the custom suppression list.
- Click Save.
If you do not have the AWS CLI yet, install and configure it.
Add the recipient's address to the stop list:
aws sesv2 put-suppressed-destination \
--endpoint-url=https://postbox.cloud.yandex.net \
--profile <profile_name> \
--email-address <recipient_address> \
--reason <reason for adding>
Where:
--email-address: Recipient's address you want to add to the custom suppression list.--reason: Reason why the recipient's address should be added to the custom suppression list.
To add a recipient's address to a custom suppression list, use the PutSuppressedDestination method.
If the address is already on the suppression list, a new entry is not created: the reason and time of the change are updated for the current entry.
Viewing a suppression list
- Navigate to Cloud Postbox.
- In the left-hand panel, select Suppression list.
For each address on the custom suppression list, the following details are displayed: the reason and date of addition and, if the address was added to the list automatically, the message ID of the email that caused this.
Get a list of addresses in the suppression list:
aws sesv2 list-suppressed-destinations \
--endpoint-url=https://postbox.cloud.yandex.net \
--profile <profile_name> \
--reasons COMPLAINT \
--page-size 50
The --reasons, --start-date, and --end-date parameters are optional. Without them, addresses are returned with all reasons over all time.
To view a custom suppression list, use the ListSuppressedDestinations method.
Addresses are returned sorted from most recently modified to oldest. You cannot find a specific address on the list using a filter: to check if an address is on the suppression list, look at the address details.
Viewing information about the recipient's address on the suppression list
Get address details:
aws sesv2 get-suppressed-destination \
--endpoint-url=https://postbox.cloud.yandex.net \
--profile <profile_name> \
--email-address <recipient_address>
To view information about a recipient's address on a custom suppression list, use the GetSuppressedDestination method.
If the recipient's address was added to the suppression list automatically, the response will contain the message ID of the email that caused this.
Deleting a recipient's address from the suppression list
- Navigate to Cloud Postbox.
- In the left-hand panel, select Suppression list.
- In the row with the address, click .
- Confirm the deletion.
Delete the address from the suppression list:
aws sesv2 delete-suppressed-destination \
--endpoint-url=https://postbox.cloud.yandex.net \
--profile <profile_name> \
--email-address <recipient_address>
To delete a recipient's address from a custom suppression list, use the DeleteSuppressedDestination method.
Warning
If an address is on the global suppression list, it will not be unblocked after being deleted from the custom suppression list.