---
title: "Add a suppression"
method: POST
path: "/api/suppressions"
tags: ["Email"]
---

# Add a suppression

`POST /api/suppressions`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/suppressions`
- Auth: HTTP bearer

Manually add an address to your suppression list so future sends skip it. Hard bounces and complaints are added automatically; use this for addresses you want to stop emailing. Idempotent.

## Request body

- object
  - `address` string, required: Email address to suppress
  - `reason` 'manual' | 'hard_bounce' | 'complaint': Reason (default: manual)

## Response `201`

Address suppressed

- object
  - `address` string
  - `reason` string
  - `source` string
  - `created_at` string, date-time
  - `hint` string

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)