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.commatchesuser@example.com. - A send skips suppressed addresses, goes to the other recipients, and lists the skipped addresses in
suppressedon the response. Each skipped address gets adroppedevent. If every recipient is suppressed, the send returns200withqueued: falseand nothing is sent. SMTP refuses each suppressed address with550 suppressedand 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
- Type the address into the search box in the top bar (placeholder
Search anything ..., shortcut ⌘K or Ctrl K). - 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
- In the sidebar, open Controls → Suppressions, then select Suppress address.
- Enter the Email. If your team has extra tenants, choose the Tenant.
- 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.
- On Suppressions, select Import CSV.
- Choose a CSV file. Use one address per line, or a column named
email,address, orrecipient. - Choose the Reason for the list: Bounce, Spam report, Unsubscribe, or Manual.
- If your team has extra tenants, choose the Tenant.
- 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.
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
- On Suppressions, select Bulk delete.
- 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.
- 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.