Suppress an address
POST/api/v1/suppressions
POST /suppressions
curl -X POST 'https://www.unitpost.com/api/v1/suppressions' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'User-Agent: my-app/1.0' \
-H 'Content-Type: application/json' \
-d '{ }'Response · 200
{
"object": "suppression",
"id": "id_123",
"email": "customer@example.com",
"scope": "workspace",
"reason": "bounce",
"detail": "string",
"note": "string",
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}Block one address ({ email }) or up to 1,000 at once ({ emails: [...] }) from receiving any future sends from your workspace. The operation is idempotent — re-suppressing an existing address returns 200 rather than a conflict. The bulk form returns an { object: "list", added, skipped, total } summary. Suppression is the hard stop; to let recipients opt out of just one kind of email, use topics (see Create a topic). Undo with Un-suppress an address. Requires the suppressions:write capability.
Request body4 fields
| Field | Type | Description |
|---|---|---|
email | string | — |
emails | string[] | — |
reason | enummanual | import | api | — |
note | string | — |
200201401403422