Deliverability

Unsubscribe

A personal link in every email, the one-click button Gmail and Yahoo require, and a page with your brand. Same for campaigns, the API and SMTP.

How it works

  1. 1

    Add the link

    Put [unsubscribe] where you want the link — usually the footer.

  2. 2

    We make it personal

    Each recipient gets their own link, plus the one-click header Gmail and Yahoo require.

  3. 3

    One click, done

    From the link or the Unsubscribe button in their inbox. No login, no confirmation email.

Turn it on

Pick how you send.

Email API

One field

Add it to your send request next to the tracking fields.

"unsubscribe": true
Track API emails

SMTP

One header

Add it to the message. It is removed before delivery.

X-Sendcorex-Unsubscribe: true
Track SMTP emails

Campaigns

Already on

Every campaign email carries the link and the one-click header. Nothing to set.

The link

Any of these in the body becomes the recipient's personal link. Use it as an href or as plain text — capital letters don't matter.

Footer example
<p style="font-size:12px;color:#888">
  Don't want these emails?
  <a href="[unsubscribe]">Unsubscribe</a>
</p>

What the recipient sees

The unsubscribe page

Your logo, your colors and where to send people after. Turn each option on or off in the dashboard.

Unsubscribe

One button. The contact is unsubscribed right away and sees a confirmation.

Receive less

Instead of leaving, the contact asks for less. They get the tag pref:weekly_digest — filter it in a segment.

Choose email types

The contact turns off the types you list (news, offers…). Each one becomes a tag pref:no_<type>.

"I still get emails"

If someone keeps receiving after leaving, they can tell you. We apply the unsubscribe again and email you a report.

Customize your page

One unsubscribe, the whole account

For the whole account

The contact becomes Unsubscribed in your contacts, no matter which email the link came from. Campaigns skip them on their own.

See who left

Contacts → filter Unsubscribed, or in Analytics open a send and press "Unsubscribed".

Bring someone back

Only if they ask you to: open the contact in Contacts and set the status to Subscribed.

Counted per send

Each campaign and track shows how many unsubscribed from it, next to opens and clicks.

Use your own

Already have an unsubscribe system? Leave ours off and send your headers. When ours is on, yours are replaced — never both.

headers (API) or message headers (SMTP)
List-Unsubscribe: <https://yourdomain.com/unsubscribe?u=123>, <mailto:unsubscribe@yourdomain.com>
List-Unsubscribe-Post: List-Unsubscribe=One-Click

With your own system, removing the contact is up to you — Sendcorex doesn't know they left.

Webhook

Keep your own database in sync: every unsubscribe fires the unsubscribe webhook event with:

FieldWhat it is
recipientEmailWho unsubscribed.
scopeall — the unsubscribe is for the whole account.
campaignIdThe campaign the link came from, or null for API and SMTP emails.
trackIdThe track the link came from (API and SMTP emails with a track).
affectedListIdsThe contact list the recipient was reached through, when there is one.
Set up webhooks

Errors

CodeWhereWhen
MISSING_UNSUBSCRIBE_PLACEHOLDERAPI · 400unsubscribe is true but the body has no placeholder. Nothing is sent.
554 5.6.0SMTPSame, through SMTP. Nothing is sent.
UNSUBSCRIBE_UNAVAILABLEAPI · 503Temporarily down. Nothing is sent — try again in a moment.
451 4.3.0SMTPSame, through SMTP. Your library retries on its own.