SDKSeptember 2026
Custom headers on send
Set message headers on send(), including the one-click unsubscribe Gmail and Yahoo require of bulk senders.
- Pass a
headersmap tosend()in@wraps.dev/emailor@wraps.dev/email/workers. SetList-Unsubscribeto your unsubscribe URL andList-Unsubscribe-PosttoList-Unsubscribe=One-Clickto get the unsubscribe button in Gmail and Yahoo - Your unsubscribe URL must accept an HTTPS POST and unsubscribe without a confirmation page. Mail clients POST to it and link scanners only GET it, so a GET should not unsubscribe anyone
- Headers are checked before anything is sent. Reserved names such as
From,To,SubjectandReply-Tothrow aValidationError, and so do values with line breaks or over SES’s length limits - On Node, a send with headers goes out through
SendRawEmail. Roles deployed by Wraps already allow it. If you send with your own IAM policy, addses:SendRawEmail
Email SDK v0.14.0

