---
title: "Unsubscribe the token's address (idempotent; RFC 8058 one-click)"
method: POST
path: "/email/unsubscribe/{token}"
tags: ["Email"]
---

# Unsubscribe the token's address (idempotent; RFC 8058 one-click)

`POST /email/unsubscribe/{token}`

## Request

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

Adds the token's address to email_suppressions (ON CONFLICT DO NOTHING) and
renders a done page. Target of the confirm page's button and of the RFC 8058
one-click POST (`List-Unsubscribe=One-Click` body, ignored). Malformed or
unknown token: 404 page. Rate-limited per IP, per machine (30/min).

## Path parameters

- `token` string, required

## Response `200`

Unsubscribed (also on a repeat)

## Other responses

- `404`: Malformed or unknown token
- `429`: Rate limited
- `500`: Write failed (generic page, no detail)

---

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