🛡️ Suppression List Management

The suppression list is a critical safeguard that protects your email deliverability and sender reputation. It automatically prevents notifications from being sent to problematic addresses—like invalid emails, spam complainers, or unsubscribed users.

Why this matters

Repeatedly sending to suppressed addresses can damage your domain reputation with email providers (Gmail, Outlook, etc.), causing all your emails to land in spam folders—even for users who want to receive them. The suppression list prevents this by blocking sends to addresses that could hurt your deliverability.

This feature gives you full visibility into suppressed recipients, helps you understand why they were suppressed, and lets you remove them when appropriate (for example, after confirming an email address is now valid or a user has explicitly opted back in).

What you can do

  • View all suppressed recipients: See every suppressed user across your workspace.
  • Filter and search: Quickly find suppressed recipients with filters in the Users tab.
  • One‑click removal: Remove a user from suppression instantly when circumstances change (for example, they fix their email configuration or opt‑in again).

Where to manage suppression

Users tab

  1. Open the Users tab in the dashboard.
  2. Use the “Show Only Suppressed Users” filter to list suppressed recipients.
  3. Hover over “On suppression list” to show a popup with info about the suppression list.
  4. Click “Remove Suppression” to re‑enable future sends when appropriate.

View Suppressed User Logs

There are two ways to view logs for a suppressed user:

Option 1: From the Users tab

  1. Open the Users tab in the dashboard.
  2. Use the “Show Only Suppressed Users” filter to find the suppressed recipient.
  3. Click the “Logs” button next to the user to view all logs specific to that user.

Option 2: From the Logs tab

  1. Open the Logs tab in the dashboard.
  2. Filter by the user’s email address or other criteria to find failed notification attempts.
  3. Review the log entries to see why notifications failed (e.g., bounced, suppressed).
TIP

Removing a recipient from suppression re‑enables future sends for that address. It does not re‑send past notifications.

API access

Prefer to manage suppression programmatically? Use our REST endpoint:

Best practice

Keep automated suppression for hard bounces and complaints. Use manual removals only after confirming the address is valid and the recipient wants to receive your emails.

Get started

  1. Go to the Users tab and enable the suppression filter to review suppressed recipients.
  2. Use the Logs tab to investigate delivery failures for suppressed users.
  3. Integrate the API to automate suppression management in your backend as needed.

Frequently Asked Questions

Why do users end up on the suppression list?

Users are automatically added to the suppression list to protect your domain reputation and email deliverability. Common reasons include:

  • Hard bounces: The email address is invalid or doesn’t exist
  • Spam complaints: The recipient marked your email as spam
  • Unsubscribes: The recipient opted out of receiving emails

When should I remove a user from suppression?

Only remove users from suppression when you’ve confirmed:

  • The email address is now valid (if it was a hard bounce)
  • The recipient has explicitly opted back in to receive emails
  • You’ve resolved the underlying issue that caused the suppression