Repository navigation
Add RFC 8058 one-click unsubscribe headers to all marketing sends #23
Description
Gmail and Yahoo expect bulk senders to support one-click unsubscribe.
Campaign and sequence sends (e.g. automation/process-ongoing-sequence.ts) call sendMail without List-Unsubscribe headers, as far as a code search shows. Only the transactional path forwards caller-supplied headers. Please verify no ESP layer adds them, then:
- Set
List-Unsubscribe(mailto and https) andList-Unsubscribe-Post: List-Unsubscribe=One-Clickon every broadcast and sequence email. - Sign the unsubscribe URL per contact and team, and handle the POST without a confirmation page.
- Add tests for the headers and the one-click endpoint.
Related: #7 (unsubscribe reporting). Inspired by a review of https://github.com/marclou/mailcheap.
Activity
clbotdev commentedon Oct 10, 2026
Notes from the follow-up review of https://github.com/marclou/mailcheap (
lib/unsubscribe.js,app/api/unsubscribe/route.js):sendMailsets only what the caller passes, and only the transactional path forwards headers.GET /unsubscribe/:tokenunsubscribes as soon as it's fetched, so link scanners unsubscribe real readers. The one-click POST from this issue and the GET → confirmation page fix should land together.