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.

Getting started

Before configuring Mailmodo as a destination in RudderStack, verify if the source platform is supported by Mailmodo by referring to the table below:

Connection ModeWebMobileServer
Device mode---
Cloud modeSupportedSupportedSupported
info
To learn more about the difference between cloud mode and device mode in RudderStack, refer to the RudderStack Connection Modes guide.

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