Skip to main content

Mailchimp Integration Documentation

How our mailchimp integration works

M
Written by Michael Lindfors
Updated this week

Overview

The Sesamy Mailchimp integration keeps your audience up to date — automatically syncing user data, tags, and activity from Sesamy straight into Mailchimp.

➡️ If you haven’t set up the integration yet, see our Mailchimp Configuration Guide.


Merge Fields

Each contact in Mailchimp is enriched with these fields from Sesamy:

Field Name

Description

Example

FNAME

User’s first name

John

LNAME

User’s last name

Smith

SESAMYUSR

Unique Sesamy user ID

email|84cccf985de28a2a84824786

PHONE

User’s phone number

+46701234567

SMYLASTSEE

When user was last active

31-12-2021

SMYSUBSC

Has active subscription (True/False)

True

SMYARTPUR

Number of articles purchased

5

SMYACTSUBS

Number of active subscriptions

2

SMYCANSUBS

Number of canceled subscriptions

1

SMYISSREM

Issues remaining in subscription

8

📌 Important: You must confirm that these merge fields exist in your Mailchimp audience before they can be used.
See Mailchimp’s guide: Getting Started with Merge Tags.

Tip: Use these fields in your campaigns for personalization — e.g.

“Hi |FNAME|, you have |SMYISSREM| issues left.”


Automatic Tags

All Sesamy-managed tags start with sesamy_, so they’re easy to recognize.

🔒 Note: Only tags that start with sesamy_ are modified by the integration. All your existing/manual tags remain untouched.

Subscription Status Tags

  • sesamy_active_subscriber – User has at least one active subscription

  • sesamy_overdue_contract – User has overdue payments

  • sesamy_has_external_access – User has external access permissions

Product & Content Tags

  • sesamy_active_entitlement_[ProductName] – Access to a specific product

  • sesamy_active_sku_[SKU] – Access to a specific SKU

  • sesamy_active_sku_po_[SKU-Option] – Access to a specific SKU option

  • sesamy_made_single_purchase – Has purchased individual articles

  • sesamy_tag_[CustomTag] – Custom tags from user profile

Examples

  • sesamy_active_entitlement_Premium Magazine

  • sesamy_active_sku_MAG001

  • sesamy_active_sku_po_MAG001-DIGITAL

💡 If you’re unsure of your SKU or Purchase Option IDs, reach out to Sesamy support and we’ll help you locate them.


Tag Management

  • Safe Integration – Only Sesamy tags are modified

  • Preserved Tags – Your existing/manual tags remain intact

  • Automatic Cleanup – Outdated Sesamy tags are removed automatically

  • No Conflicts – Works smoothly alongside other Mailchimp tools & automations


User Activities Tracked

User actions on Sesamy are logged into Mailchimp as contact activities.

Activity

Triggered When…

user_created

A new user registers

contract_purchased

User buys a subscription

checkout_completed

User completes a purchase

contract_cancel_requested

User requests a cancellation

📖 Learn more: About Contact Profile Pages.


How It Works

  • 🔄 Automatic Sync – User data is always up to date in Mailchimp

  • 🏷️ Smart Tagging – Tags are added/removed based on subscription status

  • 📊 Activity Tracking – User actions appear as Mailchimp activities

  • Real-time Updates – Sync happens instantly as users interact with Sesamy


Using This Data for Campaigns

Segmentation Ideas

  • Active Subscriberssesamy_active_subscriber

  • Churned Userssesamy_overdue_contract (great for win-back campaigns)

  • Product-Specific → use product/SKU tags for tailored offers

  • Single Purchaserssesamy_made_single_purchase for upsell campaigns

Personalization

Drop merge fields into your templates for a personal touch:

  • First name → FNAME

  • Active subscriptions → SMYACTSUBS

  • Issues remaining → SMYISSREM


Important Notes

  • Sesamy tags are limited to 99 characters (duplicates are removed automatically)

  • New users are added to Mailchimp with status “subscribed”

  • Archived users are automatically reactivated when they become active again

  • The integration respects Mailchimp’s API limits

  • For setup steps, see the Sesamy Mailchimp Configuration Guide


✨ Once connected, Sesamy gives Mailchimp a real-time feed of subscription and purchase data — so you can stop juggling spreadsheets and start running highly targeted, personalized campaigns.

Did this answer your question?