Manage suppressions & unsubscribe

The suppression list is the set of addresses a project must not send to. Send & Retain checks it on every send and keeps it up to date automatically from webhooks — you rarely touch it by hand.

How addresses get suppressed

• Complaint — the recipient reported spam. Suppressed with reason complaint, and never removable.
• Bounce — a permanent bounce. Suppressed with reason bounce.
• Unsubscribe — the recipient used the unsubscribe link. Suppressed with reason unsubscribe.
• Manual — you blocked the address yourself, or imported the address from another platform when migrating a company in.

What suppression blocks

The suppression matrix isn't all-or-nothing:

• bounce, complaint, and manual block everything.
• unsubscribe blocks lifecycle email only — transactional receipts and password resets still deliver.

The unsubscribe flow

Lifecycle emails automatically include RFC 8058 one-click unsubscribe headers and a footer link. Both point at a hosted page Send & Retain owns — you don't build it. A one-click unsubscribe adds a unsubscribe suppression; the hosted page also offers resubscribe (which removes only an unsubscribe-reason suppression).

Managing the list

Review and edit the list under Block list in the dashboard, or over the API key's automation tooling and MCP (email_list_suppressions, email_add_suppression, email_remove_suppression, email_import_suppressions). The same page imports and exports CSV.

Imports may only assert unsubscribe or manual. bounce and complaint are recorded by Send & Retain itself from provider webhooks — they describe mail we sent from your domain, so they're never something a caller can claim. Import another platform's bounces and complaints as manual with a note: it blocks the same sends and stays reversible.