Unsendbox logo
Get started
← RETURN TO ROOT
Connected

Suppressions

Use suppressions to prevent sends to risky addresses and protect sender reputation.

Open deliverability dashboard

What suppression does

Suppression prevents delivery attempts to specific addresses.

Add / create
Add an entry manually or through automated suppression hooks from bounce/complaint events.
List
Review all suppressed addresses and filter by reason.
Get
Inspect one entry by ID to confirm source/time and expiration.
Delete
Remove a suppression when a recovery action is approved.

Suppression reasons

Use clear reason categories to keep hygiene auditable.

  1. 01bounce: recipient repeatedly rejects outbound mail.
  2. 02complaint: recipient marks message as spam.
  3. 03unsubscribe: explicit opt-out from preference flow.
  4. 04manual: intentionally blocked by team policy.

Delivery safety playbook

Recommended sequence before and during suppression changes.

Before large sends
Keep suppression lists updated and validate reason-driven blocks.
During operations
If suppression count spikes, pause campaigns and inspect upstream source data.
After fixes
Re-run deliverability checks to confirm reduced bounce/complaint impact.

Scope: email vs domain blocking

Suppressions support two scopes that can also be managed from the Contacts page.

Email scope
Blocks a single address. Use when one recipient is problematic but the domain is fine.
Domain scope
Blocks all addresses at a domain. Use when the entire domain is untrusted or generates complaints.
From Contacts page
The Contacts page shows per-contact suppression state. Use the row actions to block by email or domain, or unblock directly.

UI + API mapping

Where to operate these controls.

  1. 01API routes: `/api/v1/organizations/{organizationId}/suppressions` for create/list/get/delete.
  2. 02Contacts page: `/dashboard/contacts` for per-contact block/unblock with email or domain scope.
  3. 03MCP side: suppressions are enforced during outbound routing, but management is typically done in UI or direct API.
  4. 04Deliverability dashboard: add, filter, and delete actions by reason and email.