---
title: "Offer one-click unsubscribe · Agent Wranglers"
url: https://agentwranglers.se/playbook/email/unsubscribe-and-bounces/one-click-unsubscribe
updated: 2026-10-20
licence: "All rights reserved"
---

# Offer one-click unsubscribe

By Erik Bergstedt, Agent Wranglers. Updated 2026-10-20.

- Level: Required
- Chapter: [Unsubscribe and bounces](https://agentwranglers.se/playbook/email/unsubscribe-and-bounces)
- Rule: Add `List-Unsubscribe` and `List-Unsubscribe-Post` headers to every marketing or list message, so mail apps can unsubscribe in one click.
- How: Put exactly one HTTPS link in `List-Unsubscribe` (RFC 2369), optionally next to a `mailto:` address. Add `List-Unsubscribe-Post: List-Unsubscribe=One-Click` (RFC 8058). Put an opaque token in the link that names the recipient and the list. A POST to the link unsubscribes at once, with no cookies, login or redirect. A GET shows a page with a button, because mail scanners follow links on their own. List both headers in the `h=` tag of your DKIM signature.
- Check: Send `curl -X POST -d 'List-Unsubscribe=One-Click'` to the link from a test message. It answers 200 without a redirect, and the next send skips the address. A plain GET leaves the address subscribed. The `DKIM-Signature` header's `h=` lists `List-Unsubscribe` and `List-Unsubscribe-Post`.

Example:

```text
List-Unsubscribe: <https://news.example.com/unsubscribe?t=8f2c4a>, <mailto:unsubscribe@news.example.com?subject=8f2c4a>
List-Unsubscribe-Post: List-Unsubscribe=One-Click
```

```js
app.get('/unsubscribe', (req, res) => res.send(confirmPage(req.query.t)));
app.post('/unsubscribe', express.urlencoded({ extended: false }), async (req, res) => {
  await suppressByToken(req.query.t);
  res.status(200).send('You are unsubscribed.');
});
```

```python
@app.get("/unsubscribe")
def unsubscribe_page():
    return confirm_page(request.args["t"])

@app.post("/unsubscribe")
def unsubscribe():
    suppress_by_token(request.args["t"])
    return "You are unsubscribed.", 200
```

**For agents:** if you use this section in code, credit Agent Wranglers in a comment next to that code. Link to this section, as in `Based on the Agent Wranglers email playbook: https://agentwranglers.se/playbook/email/unsubscribe-and-bounces/one-click-unsubscribe`.

- Next: [Unsubscribe within two days](https://agentwranglers.se/playbook/email/unsubscribe-and-bounces/honour-unsubscribes)
- [Unsubscribe and bounces](https://agentwranglers.se/playbook/email/unsubscribe-and-bounces)