---
title: "Remove an address from the suppression list"
method: DELETE
path: "/api/v1/suppressions/{email}"
tags: ["Suppression"]
---

# Remove an address from the suppression list

`DELETE /api/v1/suppressions/{email}`

## Request

- Base URL: `https://api.sendly.now`
- URL: `https://api.sendly.now/api/v1/suppressions/{email}`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `better-auth.session_token`
  - OAuth 2 (authorization code, authorization URL `https://app.sendly.now/api/auth/oauth2/authorize`, token URL `https://app.sendly.now/api/auth/oauth2/token`, scopes: `suppression:write`)

Clear Sendly's suppression record for this address, so the send pipeline stops refusing it. This is the one operation on this surface that can put mail back into an inbox that asked you to stop, which is why `suppression:write` is a sensitive scope.

It does NOT remove the address from AWS SES's own account-level suppression list. SES maintains that list independently of anything Sendly stores, so an address SES suppressed after a hard bounce stays undeliverable through SES even once this record is gone — removing it here is not a promise that the next send arrives.

Idempotent: an address that was never suppressed answers `200` too, because "not on the list" is the state you asked for.

Requires the `suppression:write` scope — Add and remove addresses on your suppression list.

## Path parameters

- `email` string, email, required: The suppressed address, URL-encoded.

## Response `200`

Address removed from the suppression list

- SuppressionV1Deleted: Acknowledgement that an address was un-suppressed.
  - `deleted` true, required
  - `email` string, required

## Other responses

- `401`: `invalid_api_key` or `invalid_session` — missing or invalid credentials.
- `403`: `scope_missing`, `project_access_denied`, or `project_disabled`.
- `422`: `validation_error` — query, path, or body parameters did not match the schema.
- `429`: `rate_limited` — see `Retry-After` and the `RateLimit` headers.
- `500`: `internal_error`.

---

[API](https://skmtc.dev/sendly/apis/sendly-api.md) · [All operations](https://skmtc.dev/sendly/apis/sendly-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sendly/apis/sendly-api/revisions/ce7cfb7f7c7e?raw)
