This article documents the structure of API requests to be used to trigger mails in Mailmodo.
Mailmodo APIs are completely RESTful and all our responses are returned in JSON.
API Gateway URL:
The Mailmodo API Gateway URL is https://api.mailmodo.com/
You need to include this before each API endpoint to make API calls. See the API documentation for more details.
API endpoint: https://api.mailmodo.com/api/v1/triggerCampaign/<campaignid>
This URL can be obtained from the 'Campaigns'->'Trigger' tab.
Go to Trigger -> Select the campaign from the list -> Setup steps
Note: Campaign Id can be provided in the URL path or in the payload with ‘campaignId’ key
API Authorization:
Mailmodo APIs are completely RESTful. All Mailmodo APIs are authorized via an API key.
Generate API Key:
Login to your Mailmodo account with appropriate credentials.
Navigate to Settings → API Keys → Show API Key to view the default API key. (You may also create a new API Key by clicking on the 'Add new API Key' button)

Request:
- Header:
'mmApiKey': '<api key value>
'
'Content-Type': 'application/json
'
- Body:
Parameters:
|
|
|
|
|
|
Response:
Parameters:
|
|
|
|
|
|
Sample Requests:
Sample CURL
curl --request POST \ --url https://api.mailmodo.com/api/v1/triggerCampaign/campaign-id \ --header 'Content-Type: application/json' \ --header 'mmApiKey: 3BP23E6-GND4HAJ-KZ05RJ3-HGS064T' \ --data '{ "email": "john@example.com", "subject": "string", "data": { "first_name": "string" }, "addToList": "string" }'
Sample axios
var axios = require('axios'); var data = JSON.stringify( {"subject":"Hi, this email is from api trigger", "email":"john@example.com", "data":{"firstName":"John"}});
var config = { method: 'post', url: 'https://api.mailmodo.com/api/v1/triggerCampaign/<campaign id>', headers: { 'mmApiKey': '<api key>', 'Content-Type': 'application/json' }, data : data };
axios(config) .then(function (response) { console.log(JSON.stringify(response.data)); }) .catch(function (error) { console.log(error); });