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
Add the link
Put [unsubscribe] where you want the link — usually the footer.
- 2
We make it personal
Each recipient gets their own link, plus the one-click header Gmail and Yahoo require.
- 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": trueTrack API emails
SMTP
One header
Add it to the message. It is removed before delivery.
X-Sendcorex-Unsubscribe: trueTrack 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.
<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.
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.
List-Unsubscribe: <https://yourdomain.com/unsubscribe?u=123>, <mailto:unsubscribe@yourdomain.com>
List-Unsubscribe-Post: List-Unsubscribe=One-ClickWith 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:
| Field | What it is |
|---|---|
recipientEmail | Who unsubscribed. |
scope | all — the unsubscribe is for the whole account. |
campaignId | The campaign the link came from, or null for API and SMTP emails. |
trackId | The track the link came from (API and SMTP emails with a track). |
affectedListIds | The contact list the recipient was reached through, when there is one. |
Errors
| Code | Where | When |
|---|---|---|
MISSING_UNSUBSCRIBE_PLACEHOLDER | API · 400 | unsubscribe is true but the body has no placeholder. Nothing is sent. |
554 5.6.0 | SMTP | Same, through SMTP. Nothing is sent. |
UNSUBSCRIBE_UNAVAILABLE | API · 503 | Temporarily down. Nothing is sent — try again in a moment. |
451 4.3.0 | SMTP | Same, through SMTP. Your library retries on its own. |