Email Unsubscribe Page

Every email campaign needs an unsubscribe option.

Netmera supports two setups. You can also support category-based opt-out.

Option 1: Netmera-hosted unsubscribe page

This is the fastest setup. You only add an unsubscribe link to your email template.

Netmera-hosted unsubscribe page supports two flows:

• Standard unsubscribe flow using global unsubscribe link

• Category-based unsubscribe flow

Global unsubscribe link

Use this link to continue with the standard unsubscribe flow.

https://cdn.netmera-web.com/unsubscribe/?appkey=@{appkey}&userid=@{email}&campaignId=@{campaignId}

Netmera-hosted Unsubscribe Page

Category-based unsubscribe link

Use this link when users should manage their email preferences by message category.

To open the category-based unsubscribe page, add category=true to the unsubscribe URL.

https://cdn.netmera-web.com/unsubscribe/?appkey=@{appkey}&userid=@{email}&campaignId=@{campaignId}&category=true

When category=true is included, Netmera opens the category-based unsubscribe page.

Users can select one or more categories and unsubscribe only from the selected categories.

Parameters:

• appkey: your Netmera application key.

• userid: your user identifier (commonly the email address).

• campaignId: the email campaign ID.

• category=true: opens the category-based unsubscribe page.

Example flow

1. Create an email campaign from the panel.

2. Add the category-based unsubscribe link to a button in the email template.

3. Send the campaign.

4. When the user clicks the unsubscribe button in the email, the category-based unsubscribe page opens.

5. The page displays the message categories configured under Panel > Settings > Message Categories.

6. The user selects one or more message categories.

7. When the user confirms, the user is unsubscribed from the selected categories.

8. If the user selects Unsubscribe from all categories, the user is unsubscribed from all listed message categories.

Category-based unsubscribe only removes the user from the selected message categories. It does not change the user’s general email opt-in permission. If the user wants to fully opt out from email communication, the general email permission must be managed separately.

Category-based unsubscribe page

Option 2: Custom unsubscribe page (you host)

Use this when you want full branding control. You still report the opt-out back to Netmera.

How it works

1. Put your own unsubscribe URL in the email template.

2. When the user confirms, call Netmera’s unsubscribe endpoint.

3. Optionally collect and send an unsubscribe reason.

Endpoint

Send a POST request when the user unsubscribes:

https://report.netmera.com/reporter/email-unsubscribe/{appKey}/{userId}/{campaignId}/{reason}

• appKey: required.

• userId: required. Usually the email address.

• campaignId: required.

• reason: optional. Free text or a short code.

If you send a reason, it also appears in reporting under the email unsubscribe event. This helps you analyze opt-out drivers.