---
title: "Add a suppressed address"
description: "Stop sending to an address, by hand."
url: "https://openemail.uk/docs/api/suppressions/add"
area: "API"
category: "Mailbox"
---

# Add a suppressed address

Stop sending to an address, by hand.

`POST /suppressions`

## POST /suppressions

Stop sending to an address, by hand.

## Example

Needs `settings:write`. Answers 201 with the new row, or 200 with the row already there when the address was on the list, whatever its reason. A new entry fires `suppression.added`.

**curl**

```
curl -X POST "$OE/suppressions" -H "$AUTH" -H "Content-Type: application/json" \
  -d '{ "email": "noreply@example.com" }'
```

**Response**

```
{
  "object": "suppression",
  "id": "c40a95f2-1cc6-4d31-82a8-9e075d31c2a8",
  "email": "noreply@example.com",
  "reason": "manual",
  "detail": null,
  "removable": true,
  "createdAt": "2026-09-23T10:02:17.000Z"
}
```

> A key limited to particular addresses or domains is refused with 422 `capability_unsupported`, and so is an app connected by anybody but the owner: the list stops mail from every address in the workspace.