Mailmodo Destination

Send your event data from RudderStack to Mailmodo.

Mailmodo is an interactive email marketing tool. It provides several useful features like sending transactional campaigns, email automation, and drip emails with customer journeys, WYSIWYG email editor, and many other tool integrations.

success
RudderStack also supports Mailmodo as a data source. For more information, refer to the RudderStack Connection Modes.

Connection compatibility

Destination info
  • Status: Generally Available
  • Supported sources: Android, iOS , Web, Unity, AMP , Cloud, React Native , Flutter, Cordova, Warehouse, Shopify
  • Refer to it as MAILMODO in the Integrations object.

Connection modes
SourceCloud modeDevice modeHybrid mode
AMPsupportednot supportednot supported
Androidsupportednot supportednot supported
Cloudsupportednot supportednot supported
Cordovasupportednot supportednot supported
Fluttersupportednot supportednot supported
iOSsupportednot supportednot supported
React Nativesupportednot supportednot supported
Shopifysupportednot supportednot supported
Unitysupportednot supportednot supported
Warehousesupportednot supportednot supported
Websupportednot supportednot supported
Supported message types
SourceIdentifyPageTrackScreenGroupAlias
Cloud mode
Supported sourcessupportednot supportedsupportednot supportednot supportednot supported

Get started

Once you have confirmed that the source platform supports sending events to Mailmodo, follow these steps:

  1. From your RudderStack dashboard, add a source. Then, from the list of destinations, select Mailmodo.
  2. Assign a name to the destination and click Continue.

Connection settings

To successfully configure Mailmodo as a destination, you will need to configure the following settings:

Mailmodo connection settings
  • API Key: Enter your Mailmodo API key.
info
For more information on obtaining your Mailmodo API key, refer to the FAQ section below.
  • List Name: This field is only applicable for the identify call. Enter the name of the Mailmodo list where the contacts should be added. If not provided, RudderStack is taken as the default list name.

Identify

You can use the identify call to add contacts to your Mailmodo list. If a contact already exists, RudderStack updates the contact details.

warning
You cannot add more than 100 contacts in a single identify call.

A sample identify call is shown below:

{
  "userId": "1hKOmRA4el9Z",
  "anonymousId": "78c53c15-32a1-4b65-adac-bec2d7bb8",
  "context": {
    "traits": {
      "trait1": "new-val"
    },
    "ip": "14.5.67.21",
    "library": {
      "name": "http"
    }
  },
  "traits": {
    "email": "alex@example.com",
    "name": "Alex Keener",
    "firstName": "Alex",
    "lastName": "Keener",
    "age": 40,
    "phone": "+1-202-555-0146",
    "lastClick": "2020-02-02T00:23:09.544Z",
    "lastOpen": "2020-02-02T00:23:09.544Z"
  },
  "timestamp": "2020-02-02T00:23:09.544Z"
}

Supported mappings

The following table lists the mappings between the RudderStack and Mailmodo properties:

RudderStack propertyMailmodo propertyPresence
traits.email/context.traits.email/properties.emailvalues.emailRequired
traits.firstName/context.traits.firstNamevalues.data.first_nameOptional
traits.lastName/context.traits.lastNamevalues.data.last_nameOptional
traits.name/context.traits.namevalues.data.nameOptional
traits.gender/context.traits.gendervalues.data.genderOptional
traits.age/context.traits.agevalues.data.ageOptional (Integer format)
traits.birthday/context.traits.birthdayvalues.data.birthdayOptional (ISO format/UNIX timestamp)
traits.phone/context.traits.phonevalues.data.phoneOptional
traits.city/context.traits.city/traits.address.city/context.traits.address.cityvalues.data.cityOptional
traits.address/context.traits.addressaddress1 + address2Optional
traits.state/context.traits.state/traits.address.state/context.traits.address.statevalues.data.stateOptional
traits.country/context.traits.country/traits.address.country/context.traits.address.countryvalues.data.countryOptional
traits.zipcode/context.traits.zipcode/traits.postalcode/context.traits.postalcode/traits.postal_code/context.traits.postal_codevalues.data.postal_codeOptional
traits.designation/context.traits.designationvalues.data.designationOptional
traits.company/context.traits.companyvalues.data.companyOptional
traits.industry/context.traits.industryvalues.data.industryOptional
traits.description/context.traits.descriptionvalues.data.descriptionOptional
traits.anniversaryDate/context.traits.anniversaryDate/traits.anniversary_date/context.traits.anniversary_datevalues.data.anniversary_dateOptional (ISO format/UNIX timestamp)
info
RudderStack sends any property apart from the ones mentioned above as a custom property inside traits/context.traits and maps it to values.data before sending it to Mailmodo.

Track

You can use the track call to add custom events for a contact.

A sample track call is shown below:

{
  "userId": "1hKOmRA4el9Z",
  "anonymousId": "78c53c15-32a1-4b65-adac-bec2d7bb8",
  "event": "Product Purchased",
  "properties": {
    "name": "Shirt",
    "email": "alex@example.com",
    "revenue": 4.99
  },
  "context": {
    "ip": "14.5.67.21",
    "library": {
      "name": "http"
    }
  },
  "timestamp": "2020-02-02T00:23:09.544Z"
}

Supported mappings

The following table lists the mappings between the RudderStack and Mailmodo properties:

RudderStack propertyMailmodo propertyPresence
eventevent_nameRequired
traits.email/context.traits.email/properties.emailemailRequired
timestamptsOptional (UNIX epoch in seconds)
propertiesevent_propertiesOptional

FAQ

Where can I find the Mailmodo API key?

To obtain your Mailmodo API key, follow these steps:

  1. Log into your Mailmodo dashboard.
  2. Go to Settings > API Keys as shown:
Mailmodo API key

Questions? Contact us by email or on Slack