Catalog / Cloudflare Developer Platform
Email Service - Suppress recipients for one sending domain
Email Sending suppressions now have a scope:
account: The suppression applies to every sending domain and subdomain in your account. This is the default.sending_domain: The suppression applies to one sending domain only. A suppression formail.myappexample.comdoes not block mail frommyappexample.com.
Most importantly, Email Sending now automatically creates bounce and complaint suppressions at the sending-domain level. This provides greater granularity by preventing an issue with one sending domain from suppressing the recipient across your entire account.
To add a suppression for one sending domain in the dashboard, go to Email Sending > Suppressions and select Sending domain in Scope. Imports can also set a scope for each row or a default scope.
In the API, pass scope when you create the suppression:
curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/email/sending/suppressions \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"email": "user@example.net",
"scope": { "type": "sending_domain", "value": "mail.myappexample.com" }
}'
The suppressions API returns scope on every suppression. To list the suppressions for one domain, use scope_type=sending_domain&scope_value=mail.myappexample.com. If you omit scope, the API creates an account suppression, so existing integrations continue to work.
Refer to Suppression lists and Manage suppressions for details.