---
title: "Suppress an address"
method: POST
path: "/suppressions"
tags: ["Suppressions"]
---

# Suppress an address

`POST /suppressions`

## Request

- Base URL: `https://www.unitpost.com/api/v1`
- URL: `https://www.unitpost.com/api/v1/suppressions`
- Auth: HTTP bearer

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](#post-email-topics)). Undo with [Un-suppress an address](#delete-suppressions-id). Requires the `suppressions:write` capability.

## Request body

- SuppressionCreate
  - `email` string
  - `emails` string[]
  - `reason` 'manual' | 'import' | 'api'
  - `note` string

## Response `200`

Already suppressed (single → the `Suppression`), or the bulk summary (`{ object: "list", added, skipped, total }`).

- union
  - Suppression
    - `object` 'suppression', required
    - `id` string, required
    - `email` string, required
    - `scope` 'workspace' | 'platform', required
    - `reason` 'bounce' | 'complaint' | 'unsubscribe' | 'manual' | 'import' | 'api', required
    - `detail` string, nullable, required
    - `note` string, nullable, required
    - `created_at` string, required
    - `updated_at` string, required
  - SuppressionBulkResult
    - `object` 'list', required
    - `added` integer, required: Addresses newly suppressed.
    - `skipped` integer, required: Addresses already suppressed (no-op).
    - `total` integer, required: Deduplicated input count.

## Other responses

- `201`: Newly suppressed (single).
- `401`: Missing or invalid API key.
- `403`: Insufficient scope.
- `422`: Validation error.

---

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