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

# Suppress an address

`POST /email/suppressions`

## Request

- Base URL: `https://api.crevio.co/v1`
- URL: `https://api.crevio.co/v1/email/suppressions`
- Auth: API key in header `Authorization`

Adds an address to the suppression list so no future send reaches it. Adding an address that is already suppressed returns the existing entry unchanged, rather than rewriting why it was suppressed.

`reason` accepts `manual` (default) and `unsubscribed`. `bounced` and `complained` are set only by the provider's delivery events, so the record of why an address bounced stays truthful.

## Headers

- `Idempotency-Key` string

## Request body

- EmailSuppressionRequest
  - `address` string, required
  - `reason` 'manual' | 'unsubscribed': Why the address is suppressed. Defaults to `manual`. Bounces and complaints are recorded automatically from delivery events and cannot be set here.
  - `metadata` object

## Response `201`

Address suppressed

- EmailSuppression
  - `object` string, required
  - `id` string, required
  - `address` string, required
  - `reason` 'bounced' | 'complained' | 'unsubscribed' | 'manual', required
  - `email_message` string, nullable, required
  - `metadata` object, required
  - `created_at` string, date-time, required

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `403`: Forbidden
- `404`: Resource not found
- `422`: Validation error
- `429`: Rate limit exceeded — 600 requests per minute per credential. Retry after the number of seconds in `Retry-After`.
- `500`: Internal server error

---

[API](https://skmtc.dev/crevio/apis/crevio-api-v1.md) · [All operations](https://skmtc.dev/crevio/apis/crevio-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/crevio/apis/crevio-api-v1/revisions/2219f18ad651?raw)