List-Unsubscribe Header

Table of Contents:

SMTPs that Support List-Unsubscribe Header 

Ongage supports adding a List-Unsubscribe header for the following vendors:

Here's a sample List-Unsubscribe header. In the case that Ongage injects this header, the link will be the default unsubscribe link, the same one that appears in the body of the email message.

List-Unsubscribe: <http://track.yourdomain.com/member/unsubscribe/?listname=espc-tech@domain.com?id=12345N>

 This header can also include an email address that you provide, but we recommend not to include it, as then the unsubscribe won't get registered in Ongage, in which case you'll then need to pipe it back to Ongage.  Moreover all unsubscribe stats won't get associated with the campaigns they occurred in unless you pass back the {{ocx_child_id}}.

How to add a List-Unsubscribe header for SendGrid connections in Ongage

1. In your SendGrid account, go to: https://app.sendgrid.com/settings/tracking .
2. Then deactivate the Subscription Tracking as illustrated below:
   
3. Ask Ongage support to configure for each of your SendGrid connections in Ongage a List-Unsubscribe header.

How to setup Custom List Unsubscribe Header for SendGrid connections in Ongage

Custom List Unsubscribe is different from Default List Unsubscribe Header. Ongage injects it and it is required to be configured if you want to have List Unsubscribe Header value in the following format.

<mailto:listrequest@example.com?subject=unsubscribe>,<https://example.com/unsubscribe.html?opaque=123456789>

If you want to implement Custom List Unsubscribe Header in above format, please follow the steps given below.

1. Create a support ticket with the following details and ask Ongage Support to enable Custom List Unsubscribe Header for your requested connection/s.
   
   1. Details of ESP connections ID/s
   2. Email Address/s to be added for each ESP Connection as “mailto:”
2. Once you get confirmation from Ongage Support for enabling Custom List Unsubscribe Header, go to ESP/SMTP Connections >> Custom Headers >> Provide with a header name and value for the header.
   
   Note: Custom List Unsubscribe Header is supported in the following Vendor connections:
   
   • Amazon SES
   • Mailgun
   • SparkPost
   • SendGrid
   • Private SMTP
   • SparkPost Enterprise
   • InboxRoad
   • Smtp.com
   • Mandrill
   • SocketLabs
   • mySMTP
   • MailJet V3

Note: One-Click List-Unsubscribe aka List-Unsubscribe-Post Header : In addition to the List-Unsubscribe header, another line - the “List-Unsubscribe-Post” - can be added. Here is an example:

List-Unsubscribe: <mailto:listrequest@example.com?subject=unsubscribe>,<https://example.com unsubscribe.html?opaque=123456789>

List-Unsubscribe-Post: List-Unsubscribe=One-Click

The List-Unsubsribe header will simply open the link from the List-Unsubscribe header in a browser, or by anti-spam software, will show a landing page which does not cause an immediate unsubscribe, but may offer a button to confirm the unsubscribe.

But List-Unsubscribe-Post allows marketers to perform a POST request on that URL and send the key/value pair which causes the unsubscribe without the need of interaction. Once List-Unsubscribe-Post header is added, the Senders need to take care that the landing pages linked in the List-Unsubscribe header are able to process the POST requests accordingly.