Use case 3: Mailmodo's Send Campaign Email API

Mailmodo makes your email marketing easy with automated emails which can be personalised with relevant information with custom templates to engage the right audiences. With Mailmodo you can send AMP emails like form submissions and subscriptions and receive the data directly to the platform you integrated.

Mailmodo integration in Lemnisk will help you to make email engagements directly from the platform through Mailmodo by passing data to the Mailmodo API. This demonstration helps you configure Mailmodo's email API with Lemnisk. As every engagement in Mailmodo demands a different payload, the payload value will be configured at the engagement level.

Prerequisites

API Docs / Reference doc: https://www.mailmodo.com/developers/4c44d1b19765f-send-campaign-email/

Valid Authorization scheme and keys: Depending on your free/paid account with your external system, OR your internal tech implementation of the API, you should have the relevant authorisation mechanism and its keys/passwords/tokens handy. Your POC from the external vendor or your tech team shall help you with the same

The API URL and the payload will be provided by the Mailmodo team.

Configuring Mailmodo' Send Campaign Email API in Lemnisk

Go to > Campaigns > Channels > External API

Step 1: Click the +Add New External API Button

Image: Add New External API

Step 2: Add Basic Details

• Name: Name the configuration as Hubspot_CreateContacts

• Description: Enter the description of your API.

• Channel: Choose the channel you want the API to communicate with your audience. Here we choose Email as our preferred channel.

Step 3: Add External API Details

HTTP Method: Here we select POST as the HTTP Method as the API is a post request to add contacts emails in the Hubspot database.

URL: Paste the following API URL https://api.mailmodo.com/api/v1/at/c/{{CAMPAIGN_ID}}

You can add parameters by creating variables at the end of the URL and declaring value inside {{value}} double curly braces. Here we added the parameter {{CAMPAIGN_ID}}in the URL and configured its default values which can be changed later while creating an engagement.

Image: URL Path Parameters

Headers: Add Headers to provide the metadata about the request. Here we added the authorization and API key in the headers to authenticate the API. The API key will be provided by the Mailmodo team.

Image: Headers

Step 5: Once all the fields are configured, click Save Details.

Demo: Configuring Mailmodo's send campiagn email API

Creating Engagement in Mailmodo's Send Campaign Email API

Step 1: Create an Engagement

Method 1 - Segment

• Go to Campaigns > Segments

• Select the Segment Name

• Click on External API on the left panel

• Click on the +Add Engagement Button

Method 2 - Channel

• Go to Campaigns > Channels

• Click on External API on the left panel

• Click on Add Engagement

• Select Segment Name from the list

• Click on Confirm And Proceed To the Next Step

Step 2: Add General details

• Engagement Name (mandatory): We named the Configuration as Mailmodo

• API(mandatory): Selecting our API as Mailmodo

• Label (mandatory): Choose a product label from the list. Click here to learn more about Product Label.

Step 3: Add a Goal Goal Type: Here we have selected the goal type as none.

Step 4: Configure Parameters

URL path parameters: This will be updated automatically as you defined in the URL path parameter while configuring the API.

Payload: Hence we configured the API in engagement level, the payload will be added in this part in every engagement.

{
  "email": "@EMAIL@",
  "data": {
    "first_name": "${LEAD_LASTNAME}"
  }
}

{
  "email": "@EMAIL@",
  "data": {
    "first_name": "${LEAD_LASTNAME}"
  }
}

Add the values for the variables declared in the payload

Gif: Configuring parameters

Here we have another payload example which varies at the engagement level.

The following payload has the variable only for email.

{
  "email": "@EMAIL@"
}

Image: Payload

Step 5: Schedule Settings You can schedule an engagement to trigger immediately or to send later by configuring the Time and Date. Here we have selected the schedule as immediate.

Step 6: Click "Save"

Demo: Creating Engagement in Mailmodo