Suppression list

The suppression list is your account-wide do-not-send list. It protects your sender reputation by making sure addresses that bounced or complained never get mailed again.

How addresses get suppressed

FieldTypeDescription
bounceautomaticA permanent (hard) bounce adds the address immediately.
complaintautomaticA spam complaint adds the address immediately.
manualyouAdded in the dashboard or via the API — for unsubscribe imports, legal requests, or known-bad addresses.

What suppression does

Suppressed recipients are removed from every send — transactional and broadcast — before handoff. If all recipients of an email are suppressed, the email is recorded with status suppressed and a suppressed event listing the skipped addresses; if only some are, the rest still receive it.

Managing the list

Dashboard → Suppressions lets you search, add, and remove addresses. The same operations are available with an API key:

GET    /suppressions?q=ada&limit=50&offset=0
POST   /suppressions        {"email": "ada@example.com", "reason": "manual"}
DELETE /suppressions/:id
Removing a bounce/complaint suppression makes the address mailable again — only do it when you're confident the underlying problem is fixed (e.g. a mailbox that was temporarily full and hard-bounced). Re-mailing complainers hurts deliverability for everyone you send to.