---
title: "Add to suppression list"
method: POST
path: "/tenants/{tenantId}/suppressions"
tags: ["Suppressions"]
---

# Add to suppression list

`POST /tenants/{tenantId}/suppressions`

## Request

- Base URL: `https://api.arkhq.io/v1`
- URL: `https://api.arkhq.io/v1/tenants/{tenantId}/suppressions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/arkhq-io/apis/ark-email-api/docs/tenants/:tenantId/suppressions/post.ts> (a function with typed inputs; its response is checked against the schema)

Add an email address to the tenant's suppression list. The address will
not receive any emails from this tenant until removed.

## Path parameters

- `tenantId` string, required

## Request body

- object
  - `address` string, email, required: Email address to suppress
  - `reason` string, nullable: Reason for suppression (accepts null)

## Response `201`

Address suppressed

- SuppressionResponse
  - `success` true, required
  - `data` object, required
    - `id` string, required: Suppression ID
    - `address` string, email, required
    - `reason` string: Reason for suppression
    - `createdAt` string, date-time, required
  - `meta` ApiMeta, required
    - `requestId` string, required: Unique request identifier for debugging and support

## Other responses

- `400`: Invalid request parameters
- `401`: Invalid or missing API key
- `404`: Tenant not found
- `429`: Rate limit exceeded
- `500`: Internal server error

## Changes

- **2026-02-08** `37bce0c9a4d7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/arkhq-io/apis/ark-email-api/changes/tenants/:tenantId/suppressions/post.md)

---

[API](https://skmtc.dev/arkhq-io/apis/ark-email-api.md) - [All operations](https://skmtc.dev/arkhq-io/apis/ark-email-api/llms.txt) - [OpenAPI document](https://skmtc.dev/arkhq-io/apis/ark-email-api/revisions/98a90852ffca?raw)