---
title: "Perform the RFC 8058 one-click unsubscribe (or confirm from the GET page)."
method: POST
path: "/unsubscribe"
tags: ["compliance"]
---

# Perform the RFC 8058 one-click unsubscribe (or confirm from the GET page).

`POST /unsubscribe`

## Request

- Base URL: `https://api.coldrig.dev`
- URL: `https://api.coldrig.dev/unsubscribe`
- Auth: none required

UNAUTHENTICATED, same credential as the GET above. This is the exact URL a compliant mail client POSTs to automatically for its own native "Unsubscribe" action (`List-Unsubscribe-Post: List-Unsubscribe=One-Click`) — no human interaction on this page in that flow — and is also what the GET confirm page's own form submits to when a human clicks through the in-body link instead. Suppresses the address account-wide immediately (visible to the very next scheduling tick, not a CAN-SPAM- style grace window) and cancels every pending scheduled send for every lead sharing that email across every campaign. Idempotent: a repeat call with the same valid token always 200s.

## Query parameters

- `tenant` string, required
- `email` string, email, required
- `sig` string, required

## Response `200`

Unsubscribed (or already was — idempotent).

## Other responses

- `400`: Missing/invalid query params or an invalid/tampered signature — no suppression applied.
- `413`: Request body too large.

---

[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)