Understanding Sesamy User Tags
Sesamy automatically tracks what each user has access to -- subscriptions, purchases, payment status -- and syncs this information to your CRM as tags. You can use these tags to build precise audience segments and send the right message to the right people.
Tags appear and disappear automatically based on what your users do. Subscribe to your premium tier? They get tagged. Cancel? The tag is removed. No manual work needed.
How tags work
Every Sesamy tag starts with
sesamy_so you can instantly recognise them in your CRMYour existing custom tags are never modified or deleted -- Sesamy only manages its own
Tags update in real time when users take action
Tag names are lowercase, hyphen-separated, and capped at 99 characters
For the complete and up-to-date list of all tag patterns, see our developer documentation.
Common tags you'll see
Here are some of the most-used tags to get you started:
Tag | What it means |
| Has at least one active subscription |
| Payment failed, still in grace period |
| Bought at least one article (permanent) |
| Access is paid for by someone else |
| Has access to a specific product |
| Has access identified by SKU |
These are just a few examples -- the full tag reference covers all patterns including SKU-option tags, custom tags, and entitlement variants.
Six campaigns you can run today
1. Recover failed payments
Target sesamy_overdue_contract. These people want to stay subscribed; they just need a reminder. Send within 24 hours for best results.
2. Convert article buyers into subscribers
Target sesamy_made_single_purchase without sesamy_active_subscriber. They've shown purchase intent; show them the value of subscribing.
3. Send product-specific newsletters
Use entitlement tags to send relevant content only. Don't send magazine content to news-only subscribers.
4. Cross-sell additional products
Target subscribers of Product A who lack entitlement tags for Product B. Easier to upsell existing customers than acquire new ones.
5. Welcome new subscribers
Trigger on sesamy_active_subscriber being added. Day 0: welcome, Day 3: getting started, Day 7: content highlights.
6. Win back former subscribers
Target users without sesamy_active_subscriber. They've subscribed before, so a good offer can bring them back.
Best practices
Combine tags for precision -- Don't just segment by "active subscriber". Add product type or billing status for targeted campaigns.
Use exclusions -- Exclude active subscribers from acquisition campaigns. Exclude recent renewals from upgrade offers.
Don't manually remove
sesamy_tags -- They'll reappear on the next sync. Change the subscription status in Sesamy instead.Check your segment size before sending -- If the numbers look off, double-check your tag conditions.
Learn more
For integration setup, the full tag reference, event types, and error handling, visit our integration documentation.