# POST /suppressions

Part of the SendHeron REST API. Base URL: `https://api.sendheron.com/api/v1`

Suppress an address by hand.

```http
POST https://api.sendheron.com/api/v1/suppressions
Authorization: Bearer <YOUR_API_KEY>
```

**Required scopes:** `suppressions:write`

**Success status:** `201`

**Rate limit:** 100/min per key, counted against the organization's WRITE ceiling (400/min).

**Body parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `email` | string | yes | Address to suppress. |
| `reason` | manual | admin | no | Defaults to `manual`. Only these two are accepted: `bounce` and `complaint` are provider-reported facts the platform records for itself. |
| `note` | string | no | Up to 1000 characters, shown to support. |

> This is the escape hatch for blocking an address before it becomes a legal complaint. Asserting a bounce or a complaint through it is refused, because that would fabricate a hard-tier record and cut off the recipient's transactional mail.


---

Rate limits: 100/min per key, counted against the organization's WRITE ceiling (400/min). Both windows are one minute; there is no hourly or daily quota.