---
title: "Unsubscribe an email recipient (issue"
method: POST
path: "/email/unsubscribe/{token}"
---

# Unsubscribe an email recipient (issue

`POST /email/unsubscribe/{token}`

## Request

- Base URL: `https://api.uptimemonitoring.com`
- URL: `https://api.uptimemonitoring.com/email/unsubscribe/{token}`
- Auth: none required

Public, unauthenticated. Also the target of RFC 8058 one-click
unsubscribe (`List-Unsubscribe-Post: List-Unsubscribe=One-Click`),
which POSTs here with no human interaction — the token lives in
the path, so no request body is required. Idempotent: a second
POST still returns the success page. A well-formed token's own
traffic never charges the rate limiter — RFC 8058 one-click
requests for many unrelated recipients commonly share one
mail-provider egress IP, and a genuinely valid unsubscribe is
never throttled by that shared traffic alone. But the lookup is
skipped, and this returns 429, if the caller's IP or the
process-wide backstop is already exhausted by PRIOR invalid
requests — checked before the store call — so a well-formed,
genuinely valid token can still be temporarily rejected once that
budget is already spent. Only a confirmed-invalid token (or
malformed input, rejected up front) actually charges the limiter,
60/hour per caller IP plus a process-wide backstop across every
IP.

## Response `200`

Unsubscribed.

## Other responses

- `404`: Unknown or malformed token. Renders the not-found page.
- `429`: Rate-limited — reachable for an unknown/malformed token, OR for a well-formed, genuinely valid token whose caller IP or the process-wide backstop is already exhausted by prior invalid attempts (checked before the store lookup). A valid token's own traffic never trips this, but it is not immune to an already-spent budget. Confirm and unsubscribe are tracked separately.
- `500`: Store failure.

---

[API](https://skmtc.dev/uptimemonitoring/apis/uptimemonitoring-com-api.md) · [All operations](https://skmtc.dev/uptimemonitoring/apis/uptimemonitoring-com-api/llms.txt) · [OpenAPI document](https://skmtc.dev/uptimemonitoring/apis/uptimemonitoring-com-api/revisions/ddcb2a8bc70f?raw)