Philipp Gaska
Optimizely
Feb 23, 2021
visibility 3895
star star star star star
(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

error Please login to comment.
Latest blogs
First Impressions of Optimizely Mark Desktop

What is Mark Desktop Optimizely have announced the release of the Mark Desktop App. Mark is the name for the Optimizely Agent Platform formerly kno...

Mark Stott | Nov 12, 2026

Your weekly experiment report is one slash (/) away with Mark

How to build a reusable report skill in Mark for Optimizely Web Experimentation. I want to share something with my fellow CROs. I love using Mark...

Polly Walton | Nov 12, 2026

Why your GeoPoint never reaches Optimizely Graph, and how to fix it

Geo search lets Optimizely Graph match and rank content against geographic coordinates, so applications can deliver location-aware experiences such...

K Khan | Nov 11, 2026

Mark goes desktop: what's new in Optimizely Agent Platform, November 2026

Optimizely's November release for Mark, the Optimizely Agent Platform, is one of the most significant updates since the platform launched. Two...

Scott Reed | Nov 11, 2026

Upgrading Optimizely CMS 13 from .NET 10 to .NET 11

How to upgrade Optimizely CMS 13 to .NET 11, including a workaround for edit mode and an Azure gotcha.

Tomas Hensrud Gulla | Nov 11, 2026 |

Migrating a Full Website to Optimizely CMS 13 with Visual Builder in Four Hours

Four prompts, fourteen agents and one evening: how AI agents rebuilt umage.ai on Optimizely CMS 13 with Visual Builder, starting from an empty...

Allan Thraen | Nov 11, 2026 |