---
title: "Permanently suppress an email address account-wide."
method: POST
path: "/leads/suppress"
tags: ["leads"]
---

# Permanently suppress an email address account-wide.

`POST /leads/suppress`

## Request

- Base URL: `https://api.coldrig.dev`
- URL: `https://api.coldrig.dev/leads/suppress`
- Auth: HTTP bearer

The manual/free-text "stop emailing me" path for opt-outs the strict typed-unsubscribe matcher misses. Cancels every pending send and marks every campaign-lead row for this email suppressed. There is no un-suppress endpoint.

## Request body

- SuppressLeadInput
  - `email` string, email, required
  - `reason` 'manual': Pinned to "manual" — the only value an external caller can claim. bounce/soft_bounce/complaint/unsubscribe are exclusively system-derived elsewhere.
  - `note` string: Accepted for schema symmetry; not persisted (suppressions carries no note column).

## Response `200`

Suppressed.

- SuppressLeadResult
  - `suppressed` true, required
  - `alreadySuppressed` boolean, required

## Other responses

- `400`: Request body failed schema validation.
- `401`: Missing, invalid, or inactive bearer token.

---

[API](https://skmtc.dev/coldrig/apis/agent-cold-email-api.md) · [All operations](https://skmtc.dev/coldrig/apis/agent-cold-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coldrig/apis/agent-cold-email-api/revisions/242a462d82c4?raw)