Manually adding an email address to a domain’s blocklist is only available for users who have a Scaleway domain and subscribe to the TEM Scale plan for that domain’s Project.
How to manage Transactional Email blocklists
The Transactional Email (TEM) blocklist feature allows you to manage email addresses that generate errors, or “bounces”. Emails are automatically blocked when a mailbox does not exist, or is full, to prevent sending emails to a recipient address that is not reachable. You can also add emails to the blocklist manually if you subscribe to the TEM Scale plan and have a Scaleway domain.
Before you startLink to this anchor
To complete the actions presented below, you must have:
- A Scaleway account logged into the console
- Owner status or IAM permissions allowing you to perform actions in the intended Organization. For blocklists your can apply the
TransactionalEmailBlocklistFullAccess
permission - Configured your domain(s) with Transactional Email
How to add an email address to the blocklistLink to this anchor
You can manually add addresses to your blocklist in the Scaleway console. Once added, the email remains blocked indefinitely until you [unblock it](# how-to-unblock-an-email-address) manually.
- Click Transactional Email in the Managed Services section of the console side menu. Your domains display.
- Click the domain for which you want to manage the blocklist. An overview of your domain appears.
- Click the Blocklist tab.
- Click Add to blocklist. A pop-up appears.
- Enter the recipient emails you wish to prevent from receiving emails from your domain.
Important
You can separate each email address by a comma to add multiple emails at once.
- (Optional) Provide a reason for blocking the address.
- Select a flag between:
Mailbox not found
- when mailbox does not existMailbox full
- when the mailbox is full.
- Click Add to blocklist. The email is added to your blocklist.
How to monitor temporary blocklistsLink to this anchor
If any of your emails bounced, you will see a temporary blocklist entry, with a duration of 48 hours, containing the details of the email that bounced and the reason, or flag. Some examples of bounce reasons are:
Mailbox not found
- when mailbox does not existMailbox full
- when the mailbox is full.
The temporary blocklist entry is created automatically to prevent repeated attempts to send emails, which could damage your reputation.
To see the blocklist:
- Click Transactional Email in the Managed Services section of the console side menu. Your domains display.
- Click the domain whose blocklist you want to manage. An overview of your domain appears.
- Click the Blocklist tab. Your blocklist displays, detailing the recipient email, the flags, the date the block began, and when it ends.
You can create webhooks for the following blocklist events:
email_blocklisted
- An email was blocked by an active blocklist.blocklist_created
- A blocklist was created for an email address. Any new emails sent by the address will be blocked.
By setting up a blocklist webhook, you can track changes to your blocklist in real time.
How to unblock an email addressLink to this anchor
You can unblock any address that was added to the blocklist. This is useful in cases where:
- A temporary error has been corrected. The recipient has freed up space in their mailbox, for example.
- An address becomes valid again after an update.
You can unblock up to five addresses every 24 hours.
-
Click Transactional Email in the Managed Services section of the console side menu. Your domains display.
-
Click the domain whose blocklist you want to manage. An overview of your domain appears.
-
Click the Blocklist tab. Your blocklist displays.
-
Click Unblock next to the email address you wish to unblock. A pop-up appears to warn you to:
ImportantMake sure the issue causing the email’s rejection is resolved before unblocking it to protect your reputation score and ensure optimal email deliverability.
-
Type UNBLOCK and click Unblock if you wish to continue. The email address is removed from your blocklist.