Mailmojo
The Sesamy Mailmojo integration syncs contact data, tags, and account fields into your Mailmojo list, preserving existing non-Sesamy tags and conditionally updating name and phone fields.
Overview
Mailmojo is a Norwegian email marketing platform. Once connected, Sesamy automatically syncs subscriber email, name, phone, tags, and a standard set of account fields to your Mailmojo list on every event. The integration is careful to preserve data you have already entered -- name and phone fields are only written when the existing contact has no value.
Setup
To connect Mailmojo, provide the following credentials to Sesamy support.
| Field | Type | Description |
|---|---|---|
apiToken | string | Your Mailmojo API token |
listId | string | The list ID to sync contacts to |
apiUrl | string | (Optional) Custom API endpoint URL |
1. API Token
Generate an API token in your Mailmojo account settings. This token allows Sesamy to create and update contacts in your account.
2. List ID
Provide the ID of the Mailmojo list where Sesamy should sync contacts. You can find this in your Mailmojo list settings.
3. Complete the Setup
Send your API token and list ID to Sesamy support to finalise the integration.
Account fields are auto-created
You do not need to create the account (custom) fields in Mailmojo manually. On first sync, Sesamy checks for the standard Sesamy field set and creates any that are missing on your account.
What Gets Synced
Contact Data
| Field | Type | Description |
|---|---|---|
email | string | Always synced |
first_name | string | Only written if the existing contact has no value |
last_name | string | Only written if the existing contact has no value |
phone | string | Only written if the existing contact has no value |
Existing data is preserved
The integration never overwrites name or phone data that already exists in Mailmojo. If you need to update these fields, do so directly in Mailmojo.
Phone number priority
When multiple phone numbers exist on the Sesamy user profile, the integration uses this priority chain: mobile, default, work, home.
Account Fields
Sesamy registers and maintains the following account fields on your Mailmojo list. They are set on the contact's custom property on every sync. The field names in Mailmojo match the displayed names below.
| Field | Type | Description |
|---|---|---|
Sesamy User ID | text | The user's unique Sesamy ID |
Has Active Subscription | boolean | Whether the user currently has at least one active subscription |
Articles Purchased | number | Number of articles the user has purchased |
Active Subscriptions | number | Number of currently active subscriptions |
Canceled Subscriptions | number | Number of cancelled subscriptions |
Expired Subscriptions | number | Number of naturally expired subscriptions |
Ended Subscriptions Total | number | Total ended subscriptions (cancelled + expired) |
Issues Remaining | number | Issues remaining on active subscriptions |
Subscription Expires At | date | When the primary active renewable contract expires (YYYY-MM-DD) |
Contract Duration Type | text | Duration type of the primary active contract |
Last Payment Date | date | When the user was last billed |
Next Payment Date | date | When the user is next scheduled to be billed |
Will Cancel At | date | Scheduled cancellation date, if any |
Field values are always refreshed
Account field values are re-derived from Sesamy state on every sync. When a value no longer applies (for example, Will Cancel At after a scheduled cancellation is undone), Sesamy clears the field so stale data is not left behind.
Tags
Standard Sesamy tags are synced to contact records. See Integration Concepts for the complete tag reference.
Tags are merged on every sync:
- New
sesamy_tags are added - Outdated
sesamy_tags are removed - External tags (those not starting with
sesamy_) are preserved
This means your manually added tags and tags from other tools are never affected.
Events
The Mailmojo integration responds to all eight standard Sesamy events. Every event triggers a sync of the contact's data, tags, and account fields.
See Event Types for the full list of events.
Using This Data for Campaigns
Segmentation Ideas
- Active Subscribers -- filter on
Has Active Subscription = trueor thesesamy_active_subscribertag - Renewal Reminders -- filter on
Subscription Expires Atwithin the next 14 days - Win-back Campaigns -- filter on
Expired Subscriptions > 0andHas Active Subscription = false - Engaged Readers -- filter on
Articles Purchased > 0
Personalisation
Drop account field values into your Mailmojo templates to personalise content -- for example referencing Issues Remaining in renewal nudges, or Next Payment Date in payment reminders.
Important Notes
- Guest users are not supported -- temporary guest accounts created during checkout are excluded from sync.
- Users without email are skipped -- the integration requires an email address to create or update a contact. Users without one are silently skipped.
- Tag safety -- only
sesamy_tags are modified. External tags are never removed. - Account field safety -- only Sesamy-managed account fields are written. Other custom fields on the contact are left untouched.
Alternative Integration Method
For more advanced integrations, you can use both APIs directly:
- Use Sesamy Webhooks to receive subscription events
- Call the Mailmojo API to manage contacts
Next Steps
- Integration Concepts -- shared concepts, event types, and tag reference
- Mailchimp -- email marketing with merge fields and activity tracking
- HubSpot -- CRM contact sync with subscription properties
- Make.as -- subscriber data, product catalogues, and subscription sync
- Handling Webhooks -- build your own webhook endpoint