Five New Optimizely Certifications are Here! Validate your expertise and advance your career with our latest certification exams. Click here to find out more

Philipp Gaska
Feb 23, 2021
  2380
(3 votes)

Working with newsletter unsubscribes

In the blog post Setting up a newsletter subscription via REST API, I described how to use a double opt-in process to acquire new recipients in a legally secure way. Even if you do not want to lose the recipients you have acquired, it is essential to include an unsubscribe option in the newsletter and on your website. This is a basic requirement for serious email marketing because you should send your information only to those who are interested in it.

Including an unsubscribe link in your newsletter

In Episerver Campaign, you can easily implement the newsletter unsubscription via an unsubscribe link. Add the {Unsubscribe Link} field function in the newsletter footer after the greeting and contact information.

When the recipients click on the link, they are added to Episerver Campaign's system-internal unsubscribe list. The recipients are not removed from the recipient list but are matched against the unsubscribe list in the future and skipped when the newsletter is sent.

Also, the unsubscribe link redirects to a default confirmation page. If you want to use your own confirmation page, you can change it in Episerver Campaign.

Image: Changing the confirmation page URL in Episerver Campaign

Setting up an unsubscribe form on your website

In addition to the unsubscribe link in the newsletter, you should also provide an unsubscribe form on your website. Like the newsletter subscription, you can do this by using the Episerver Campaign REST API. Create a form and set up the API request using the POST/{clientId}/unsubscribes operation. 

Note: Set up the REST API in your client first, see Client setup.

One advantage of an unsubscribe form is that you can ask for the unsubscribe reason and offer an opt-down. Since you do not want to lose your newsletter recipients completely, you can offer to receive an alternative newsletter with a lower sending frequency - for example, monthly instead of weekly. This way you create an unsubscribe form including a new subscription option and keep your unsubscribe rates low.

For further information and tips on how to create subscription and unsubscribe forms, see the Episerver User Guide

Managing unsubscribes

Monitor your newsletter unsubscribes and make sure that the unsubscribe process is working properly. 

  • Are all newsletter unsubscribes processed by the unsubscribe link in your database as scheduled? 
  • Do you also fulfill individual unsubscribe requests that reach you through reply emails? 

Therefore, regularly check the correct handling of your unsubscribe processes to avoid legal or provider-related problems. To monitor and manage unsubscribes, you can use the Episerver Campaign REST API. 

In order to view the system-internal unsubscribe list, use the GET/{clientId}/unsubscribes operation. The request in curl looks as follows:

curl -X GET "https://api.campaign.episerver.net/rest/123456789/unsubscribes?sort=created" -H "Authorization: BASIC k783r3fjn989dhnfjjdr83dgds1383NDfv="

The Unsubscribes REST API resource provides even more operations for managing unsubscribes:

Image: Unsubscribes REST API resource

Feb 23, 2021

Comments

Please login to comment.
Latest blogs
COGNITIVE_SERVICE_TRANSLATE_ERROR

COGNITIVE_SERVICE_TRANSLATE_ERROR

Tomas Hensrud Gulla | Mar 19, 2025 |

Secure Your CMS: A Guide to the OptiAccess Restrictor Add-on

The OptiAccess Restrictor add-on enhances CMS security by preventing unauthorized access, allowing IP whitelisting.

Francisco Quintanilla | Mar 18, 2025 |

Optimizely CMS Developer Tools for macOS

Running Optimizely CMS on macOS presents unique challenges, as the platform was traditionally primarily designed for Windows environments. However,...

Tomek Juranek | Mar 15, 2025

Removing a Segment from the URL in Optimizely CMS 12 using Partial Routing

Problem Statement In Optimizely CMS 12, dynamically generated pages inherit URL segments from their container pages. However, in certain cases, som...

Adnan Zameer | Mar 14, 2025 |

Optimizely Configured Commerce and Spire CMS - Figuring out Handlers

I recently entered the world of Optimizely Configured Commerce and Spire CMS. Intriguing, interesting and challenging at the same time, especially...

Ritu Madan | Mar 12, 2025

Another console app for calling the Optimizely CMS REST API

Introducing a Spectre.Console.Cli app for exploring an Optimizely SaaS CMS instance and to source code control definitions.

Johan Kronberg | Mar 11, 2025 |