Learn how to manage email unsubscribe behavior in OneSignal, including unsubscribe links, List-Unsubscribe headers, suppression rules, and resubscription workflows.
include_unsubscribed
property in the create email notification API.Enable sending to unsubscribed users
subscribed
to no
.enabled : false
via the Create user, Update user, or Update subscription APIs.[unsubscribe_url]
token.List-Unsubscribe
header in all emails except when you enable “Include sending to unsubscribed users.” This helps:
[unsubscribe_url]
token, which inserts a visible unsubscribe link into your email content.
You can also create a branded experience with your own unsubscribe page. See Create a custom unsubscribe page.
HTML editor with default unsubscribe link
email_body
):
[unsubscribe_url]
placeholder is insertedUnsubscribe link in Drag & Drop editor
[unsubscribe_url]
with your own unsubscribe landing page.
To do this:
[unsubscribe_url]
in your email with the URL of your custom unsubscribe page.enabled: true
in the Create User or Update subscription APIssubscribed = yes
when importing email addresses[unsubscribe_url]
does not count towards click analytics.