How do I implement the List-Unsubscribe header correctly?

Implementing the List-Unsubscribe header correctly requires including both List-Unsubscribe and List-Unsubscribe-Post headers in your message headers. The format follows specific conventions that mailbox providers expect.

The List-Unsubscribe header should contain an HTTPS URL (and optionally a mailto address) formatted as: List-Unsubscribe: . The URL must be unique per recipient and message to identify who is unsubscribing.

The List-Unsubscribe-Post header should contain exactly: List-Unsubscribe-Post: List-Unsubscribe=One-Click. This signals to mailbox providers that your endpoint accepts POST requests for one click unsubscription. Your endpoint must process these POST requests and return appropriate HTTP responses.

Was this answer helpful?

Thanks for your feedback!