Lift a manual suppression

Remove an address this API key suppressed, or a SOFT_BOUNCE_REPEATED entry.

DELETEhttps://app.usenotix.dev/api/v1/suppressions/{email}

Needs a full access key. Sending access keys cannot call this. Key permissions lists the extra rules some calls have.

Remove an address this API key suppressed, or a SOFT_BOUNCE_REPEATED entry. Lifting a soft-bounce entry answers with a warning: if the mailbox soft-bounces 3 more times in 30 days it goes back on the list. A hard bounce or complaint answers 403: those protect your sending reputation and only Notix support can lift them. So does an entry a person added in the dashboard, an import, or another key's entry. An address that was not on the list answers 200 with removed: false.

Path parameters

emailstringrequired

Headers

Authorizationstringrequired

Bearer followed by your API key.

Errors

403

The entry is a hard bounce, a complaint, a dashboard opt-out, an import or another key's entry, or the key's creator is not a team admin.

429

More than 20 removals by this key in an hour.

503

The removal limit cannot be checked right now.

Every error has the same shape. See all error codes.

curl -X DELETE "https://app.usenotix.dev/api/v1/suppressions/<email>" \
  -H "Authorization: Bearer $NOTIX_API_KEY"
Response200
{
  "email": "customer@example.com",
  "removed": true
}
Open in ClaudeOpen in ChatGPT