Sign in to fill these examples with your own keys. Sign in Start free trial

How to manage suppressions

Look up, add, import, or remove an address PostShiba will not send to.

The suppression list holds addresses PostShiba will not send to. This guide shows how to check an address, add or import addresses, and remove one or many.

How the list works

  • Rows are unique per team and tenant. With extra tenants, each tenant has its own list.
  • Plus tags are ignored when matching, so user+promo@example.com matches user@example.com.
  • A send skips suppressed addresses, goes to the other recipients, and lists the skipped addresses in suppressed on the response. Each skipped address gets a dropped event. If every recipient is suppressed, the send returns 200 with queued: false and nothing is sent. SMTP refuses each suppressed address with 550 suppressed and delivers to the rest.
  • No header or per-send option skips the list, on SMTP or the API. To send test or verification emails without suppressing the addresses that hard bounce, send them from a tenant that stops suppressing hard bounces.
Reason How the row got there
Bounce A hard bounce. See Email bounces.
Spam report The recipient reported the message as spam.
Unsubscribe The recipient used one-click unsubscribe. See How do recipients unsubscribe?.
Manual You added the address, or imported it without another reason.

Look up an address

  1. Type the address into the search box in the top bar (placeholder Search anything ..., shortcut ⌘K or Ctrl K).
  2. Pick the recipient result to open Recipient lookup.

Recipient lookup shows recent sends, whether the address is suppressed, and whether the firewall blocks it. Selecting an address on the Suppressions page opens the same view.

Add an address

  1. In the sidebar, open Controls → Suppressions, then select Suppress address.
  2. Enter the Email. If your team has extra tenants, choose the Tenant.
  3. Select Suppress address.

Import a list

Import bounce, complaint, and unsubscribe lists from your old provider before you send. See Switching from SendGrid for an example.

  1. On Suppressions, select Import CSV.
  2. Choose a CSV file. Use one address per line, or a column named email, address, or recipient.
  3. Choose the Reason for the list: Bounce, Spam report, Unsubscribe, or Manual.
  4. If your team has extra tenants, choose the Tenant.
  5. Select Import addresses.

An import takes up to 10,000 addresses and 2 MB. The notice says how many were added, already listed, and skipped.

To mix reasons in one file, add a reason column. Each row's value wins over the reason you chose: bounce, spam report, unsubscribe, or manual. Export names from other providers work too, such as bounces, spam reports, global unsubscribes, and invalid emails. A blank or unrecognized value uses the reason you chose. Addresses already on the list keep their reason.

suppressions.csv
1email,reason 2bounced@example.com,bounce 3complained@example.com,spam report 4left@example.com,unsubscribe

Remove an address

Select Remove on the row, then confirm. Only remove an address when the recipient asked for mail again. Every removal is written to the access log.

Remove many addresses

  1. On Suppressions, select Bulk delete.
  2. Paste the addresses, choose a Reason, or both. If your team has extra tenants, you can limit it to one Tenant; otherwise every tenant is included.
  3. Confirm.

One request removes up to 10,000 rows, oldest first. If more match, the notice says so; run it again. A bulk delete needs at least an address list or a reason.

The same actions are on the Suppressions API.

Next steps