Use case 3: Mailmodo's Send Campaign Email API

PreviousUse case 2: Exotel's Make a call API NextLead scoring

Last updated 1 year ago

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

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.

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.

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

Creating Engagement in Mailmodo's Send Campaign Email API

Step 1: Create an Engagement

Go to Campaigns > Segments
Select the Segment Name
Click on External API on the left panel
Click on the +Add Engagement Button

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

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

The following payload has the variable only for email.

{
  "email": "@EMAIL@"
}

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"

PreviousUse case 2: Exotel's Make a call API NextLead scoring

Last updated 1 year ago

Prerequisites

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

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

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}}

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

Creating Engagement in Mailmodo's Send Campaign Email API

Step 1: Create an Engagement

Go to Campaigns > Segments
Select the Segment Name
Click on External API on the left panel
Click on the +Add Engagement Button

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

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

The following payload has the variable only for email.

{
  "email": "@EMAIL@"
}

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"