Skip to main content
Concepts

Suppressions

The list of addresses that do not receive emails from your organization and how it is kept.

How an address gets in

The platform automatically suppresses addresses with a hard bounce or a spam complaint. You can also suppress by hand with POST /suppressions.

  • bounce: the recipient server refused permanently.
  • complaint: the recipient marked it as spam.
  • manual: you added it.
POST /suppressions
curl -X POST https://api.coffeemail.com.br/v1/product/suppressions \  -H "Authorization: Bearer $COFFEEMAIL_API_KEY" \  -H "Content-Type: application/json" \  -d '{ "email": "ana@exemplo.com.br", "reason": "manual" }'

Effect on sending

A send to a suppressed address does not go out: the email gets the skipped status and the matching event. This protects your domain reputation.

To send again, remove the suppression (DELETE /suppressions/{id}) or reactivate the recipient. Suppressions can have expiresAt.