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.

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).