---
title: "One-click unsubscribe from a catalog's alert emails (RFC 8058), no key needed"
method: POST
path: "/v1/alerts/unsubscribe/{token}"
---

# One-click unsubscribe from a catalog's alert emails (RFC 8058), no key needed

`POST /v1/alerts/unsubscribe/{token}`

## Request

- Base URL: `https://api.recallsapi.com`
- URL: `https://api.recallsapi.com/v1/alerts/unsubscribe/{token}`
- Auth: none required

What mail providers send for the List-Unsubscribe and List-Unsubscribe-Post headers of every alert email (body `List-Unsubscribe=One-Click`), and what the page's button sends. Stops alert emails to that address for that catalog; the webhook is not affected, and the owner sees `alert_email_unsubscribed_at` in GET /v1/catalogs. Idempotent; never redirects.

## Path parameters

- `token` string, required

## Response `200`

Unsubscribed, or already unsubscribed (text/html)

## Other responses

- `404`: Not a valid unsubscribe link (text/html)

---

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