How-to

Manage suppressions

View, filter, add, import, export and delete suppressions in the dashboard or with the API, configure automatic suppression, and resend suppressed emails.

Updated Oct 1, 2026

This guide covers every task on the suppression list: finding entries, adding them one at a time or from a CSV file, exporting, removing them and controlling automatic suppression. For how suppressions work, see Suppressions.

Before you begin

Any workspace member can manage the list in the dashboard. Changing automatic suppression settings requires an admin.
For the API, use an API key with Full Access.

View and filter the list

Go to Email APISuppressions. The table lists each suppression’s Email, Reason and Created at, newest first.

Search matches the email address and the reason.
Filters add rules on Email, Reason, Type or Created at, such as Type equals complaint. Press Enter or select Apply.
Display options > Edit columns shows the Type column.
Select a column header to sort by it.

Call List suppressions. You can filter on email, reason, type, created_at and keep_until:

Terminal

curl -G https://api.emailit.com/v2/suppressions \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  --data-urlencode "type.exact=complaint" \
  --data-urlencode "limit=100"

To look up one address, call Retrieve a suppression with its sup_ ID or the email address. See Filtering for every operator.

Add a suppression

Open the list. Go to Email APISuppressions and select Add suppression.
Enter the details. Type the Email and, optionally, a Reason you’ll recognize later.
Select Create. The address is added with the type recipient, which blocks all mail to it.

To add another type, or a suppression that expires, use the API or a CSV import.

Call Create a suppression:

Terminal

curl https://api.emailit.com/v2/suppressions \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "type": "unsubscribe",
    "reason": "Opted out by phone",
    "keep_until": "2027-01-01T00:00:00Z"
  }'

Field	Required	Description
`email`	Yes	The address to suppress.
`type`	No	`recipient` (default), `bounce`, `complaint` or `unsubscribe`.
`reason`	No	Free text.
`keep_until`	No	When the suppression expires: ISO 8601, a Unix timestamp or plain English such as `in 30 days`. Leave it out to suppress forever.

The same address and type can only be added once. A duplicate returns 409 Suppression already exists for this email and type.

Import a CSV file

Use an import to move a suppression list from another provider or to add many addresses at once.

Prepare the file. Use a .csv file with the columns email, type and reason:
suppressions.csv
```
email,type,reason
ada@example.com,bounce,Hard bounce at previous provider
grace@example.com,unsubscribe,Unsubscribed in 2025
alan@example.com,,Requested removal
```
- email is required. type and reason are optional.
- An empty or unknown type becomes recipient.
- The header row is optional. Without one, Emailit reads the columns in the order email, type, reason.
- The file must be smaller than 8 MB and have no more than 10,000 rows.
Upload it. On Email APISuppressions, select Import, then choose the file or drag it onto Select a file or drag it here.
Check the result. Emailit adds new entries and skips addresses that already have a suppression of the same type. Rows with invalid email addresses are skipped.

For more than 10,000 addresses, split the file. To import from code, call Create a suppression for each address.

Export the list

Narrow it down. Optionally search or filter the list in Email APISuppressions. The export includes only what’s shown.
Export. Select Export, then Export in the popover. Emailit downloads suppressions.csv.

The file has the columns email, type, reason and created_at, and contains up to 10,000 rows.

Delete suppressions

Deleting a suppression lets Emailit send to the address again. Make sure the address is valid and the person wants your mail, or the next send may bounce or draw a complaint.

One: select the trash icon on its row and confirm.
Several: select the rows with the checkboxes, select Delete suppressions and confirm.

Call Delete a suppression with the sup_ ID or the email address:

Terminal

curl https://api.emailit.com/v2/suppressions/sup_4Lm8Qr2Tz6Wk \
  -X DELETE \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

If an address has suppressions of more than one type, use the sup_ ID so you delete the right one.

To change a suppression instead, for example to add an expiry date, call Update a suppression with type, reason or keep_until. Set keep_until to null to remove the expiry.

Configure automatic suppression

Emailit adds addresses that bounce or complain to the list automatically. On Pro and Business, admins can change this.

Open the settings. Go to WorkspaceSettings and select the Suppressions tab.
Turn it on or off. Use Enable automatic suppression.
Choose what to suppress. In Suppress on, pick Bounces and Complaints (default), Bounces only or Complaints only.

On Pay as you go and Custom plans, automatic suppression is always on for bounces and complaints. The controls show a Pro badge and can’t be changed. Members who aren’t admins can view the settings but not change them. See Bounces and complaints for exactly when Emailit suppresses an address.

Retry suppressed emails

A message that was blocked by a suppression stays suppressed even after you delete the suppression. To send it:

Delete the suppression for the address, as described above. Otherwise the retry is suppressed again.
Retry the email. Open it in Email APIEmails and select Retry, or call Retry an email.

A retry creates a new email with the same content and a new ID, and costs credits like any other send. You can retry emails up to 30 days old, as long as their content is still within your data retention period.

Suppressions

Types, automatic suppression and expiry.

Bounces and complaints

When Emailit suppresses an address.

Suppressions API

Every suppression endpoint.

Email verification

Remove bad addresses before you send.