CONSOLE
Loading
Comply with Google and Yahoo's mandatory unsubscribe rules. Add RFC 8058 headers to Node.js, PHP, and Python email dispatches and handle automated POST callbacks.
RFC 8058 requires two headers: List-Unsubscribe: <https://yourdomain.com/unsubscribe?token=...> and List-Unsubscribe-Post: List-Unsubscribe=One-Click. When a recipient clicks the native 'Unsubscribe' button in Gmail or Yahoo, the receiving server sends an HTTP POST request to that URL. The sender must honor the opt-out within 48 hours without prompting the user for confirmation or login credentials.
When subscribers cannot easily locate an unsubscribe option, their instinctive reaction is to click **"Report Spam"**. High spam complaint rates (>0.10%) destroy domain reputation and cause mailbox algorithms to throttle future deliveries.
By rendering a prominent native "Unsubscribe" button directly adjacent to the sender name in the webmail UI, mailbox providers enable frictionless opt-outs, protecting your primary inbox placement.
Under RFC 8058, compliant messages must transmit both headers in the MIME envelope:
List-Unsubscribe: <https://notifications.yourdomain.com/api/unsubscribe/usr_98a72b>
List-Unsubscribe-Post: List-Unsubscribe=One-Click
List-Unsubscribe=One-Click. Your server must NOT require authentication cookies or redirect to an HTML confirmation prompt.
const mailOptions = {
from: '"Company News" <newsletter@yourdomain.com>',
to: user.email,
subject: "Monthly Product Engineering Digest",
text: "...",
headers: {
'List-Unsubscribe': `<https://yourdomain.com/unsubscribe?token=${user.unsubToken}>`,
'List-Unsubscribe-Post': 'List-Unsubscribe=One-Click'
}
};
$mail->addCustomHeader('List-Unsubscribe', '<https://yourdomain.com/unsubscribe?token='.$token.'>');
$mail->addCustomHeader('List-Unsubscribe-Post', 'List-Unsubscribe=One-Click');
Here is a clean Express.js / Node.js endpoint to handle incoming RFC 8058 POST dispatches:
app.post('/api/unsubscribe', async (req, res) => {
const { token } = req.query;
if (!token) return res.status(400).send('Missing token');
// 1. Mark subscriber as unsubscribed in database
await db.subscribers.update({ token }, { status: 'unsubscribed' });
// 2. Respond immediately with HTTP 200 OK
res.status(200).send('Unsubscribed successfully');
});
Photon Console automatically injects RFC 8058 headers and syncs unsubscribe webhooks directly to your CRM, ensuring 100% compliance with Google and Yahoo.
Trademark Notice & Nominative Fair Use: All third-party trademarks, logos, and service marks (SendGrid®, Mailgun®, Amazon SES®, Postmark®, Resend®, Brevo®, SMTP2Go®, SparkPost®) are property of their respective owners and used under 15 U.S.C. § 1115(b)(4).
Photon Console is independent and not affiliated with or endorsed by these providers. Pricing and plan details compiled from public sources as of November 2026. Read full legal disclaimer →