Skip to the documentation
API

Add a suppressed address

Stop sending to an address, by hand.

POSTapi.openemail.uk/suppressions

Runs the real call against your workspace, with your own key.

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": "[email protected]" }'
Response
{  "object": "suppression",  "id": "c40a95f2-1cc6-4d31-82a8-9e075d31c2a8",  "email": "[email protected]",  "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.