---
title: "Block up to 100 domains (Do Not Prospect)"
method: POST
path: "/suppressions/domains"
tags: ["Suppression"]
---

# Block up to 100 domains (Do Not Prospect)

`POST /suppressions/domains`

## Request

- Base URL: `https://mcp.senders.ai/api/v1`
- URL: `https://mcp.senders.ai/api/v1/suppressions/domains`
- Auth: HTTP bearer

Scope: suppression:write. Personal email domains are refused.

## Headers

- `Idempotency-Key` string, required

## Request body

- DomainsBody
  - `domains` union[], required
    - union
      - string
      - object
        - `domain` string, required
        - `reason` 'competitor' | 'customer' | 'partner' | 'client_account' | 'other'
        - `company_name` string
        - `note` string

## Response `200`

OK

- DomainsResult
  - `data` object
    - `blocked` string[]
    - `refused` object[]
      - `domain` string
      - `reason` 'invalid_domain' | 'consumer_domain'

## Other responses

- `400`: Invalid body or missing Idempotency-Key (bad_request, idempotency_key_required)
- `401`: Missing, wrong or revoked token
- `403`: Missing write permission, inactive account, or feature not enabled
- `409`: busy, conflict, idempotency_in_progress (retry) or a final conflict such as campaign_closed
- `413`: Body over 1 MB
- `415`: Body not JSON
- `422`: Idempotency-Key reused for a different request
- `429`: Rate or daily limit
- `503`: Writes paused because rate limiting is unavailable; retry after Retry-After

---

[API](https://skmtc.dev/senders/apis/senders-rest-api.md) · [All operations](https://skmtc.dev/senders/apis/senders-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/senders/apis/senders-rest-api/revisions/3cd9960bc0af?raw)