Topic · Compliance
One-click unsubscribe endpoint
A one-click unsubscribe endpoint is a supported HTTPS destination that processes a standardized unsubscribe request without extra user interaction.
How it works
Participating clients may send a POST request following the one-click unsubscribe specification and supplied List-Unsubscribe headers.
What can go wrong
An endpoint requiring login, confirmation pages or unsafe GET side effects may fail provider expectations.
What to check or do
Validate POST handling, suppression propagation, security safeguards and idempotent behavior.
How to investigate One-click unsubscribe endpoint
- Signal to investigate
- Marketing messages contain List-Unsubscribe headers but the receiver still flags one-click support.
- Evidence to collect
- Inspect List-Unsubscribe-Post, an HTTPS URL, the endpoint response and suppression processing after an authenticated POST.
- Common wrong conclusion
- A clickable footer link or GET-based preferences page alone is not RFC 8058 one-click unsubscribe.
How to interpret the evidence
A receiver may issue a POST without opening a user browser. The endpoint must safely process the request without requiring login or a confirmation page, and must resist unrelated abuse.
What to change and how to verify it
Implement a reliable HTTPS POST handler, test suppression and consult the current destination-provider requirements.
Put this into practice
Run a focused check, then explore protection if your domain needs it.