Skip to content

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.

FieldTypeDescription
apiTokenstringYour Mailmojo API token
listIdstringThe list ID to sync contacts to
apiUrlstring(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

FieldTypeDescription
emailstringAlways synced
first_namestringOnly written if the existing contact has no value
last_namestringOnly written if the existing contact has no value
phonestringOnly 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.

FieldTypeDescription
Sesamy User IDtextThe user's unique Sesamy ID
Has Active SubscriptionbooleanWhether the user currently has at least one active subscription
Articles PurchasednumberNumber of articles the user has purchased
Active SubscriptionsnumberNumber of currently active subscriptions
Canceled SubscriptionsnumberNumber of cancelled subscriptions
Expired SubscriptionsnumberNumber of naturally expired subscriptions
Ended Subscriptions TotalnumberTotal ended subscriptions (cancelled + expired)
Issues RemainingnumberIssues remaining on active subscriptions
Subscription Expires AtdateWhen the primary active renewable contract expires (YYYY-MM-DD)
Contract Duration TypetextDuration type of the primary active contract
Last Payment DatedateWhen the user was last billed
Next Payment DatedateWhen the user is next scheduled to be billed
Will Cancel AtdateScheduled 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 = true or the sesamy_active_subscriber tag
  • Renewal Reminders -- filter on Subscription Expires At within the next 14 days
  • Win-back Campaigns -- filter on Expired Subscriptions > 0 and Has 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

Released under the MIT License.