MM Lite API is designed specifically for sending Marketing template messages. If you try to send any other message type—such as freeform, Authentication, Service, or Utility—you’ll receive an error response. These formats aren't supported in MM Lite.
It’s also important to note that MM Lite is a send-only API. It doesn’t support incoming messages from users. If your use case requires two-way communication, you’ll need to use the Cloud API alongside MM Lite on the same phone number to receive incoming messages and replies.
We demonstrated this dual setup in the Sandbox Testing guide, where Cloud API is used to receive incoming messages while MM Lite handles outbound marketing templates.
Using MM Lite API to send normal text messages
The expected error if we try to send a message which is not a Marketing template message is:
{
"detail": {
"error": {
"message": "(#100) Invalid parameter",
"type": "OAuthException",
"code": 100,
"error_data": {
"messaging_product": "whatsapp",
"details": "Message must be a template message."
},
"fbtrace_id": "AS8UhxdPr7P7WMufJGTGVGU"
}
}
}
Using MM Lite API to send Authentication/Utility templates
The expected error if we try to send a template message that is not a Marketing template message is:
The expected error if we try to send a MM Lite if the phone number is not activated for this Beta initiative:
{
"detail": {
"error": {
"message":"(#200) You must accept the Marketing Messages Lite API terms to use the API."
"type": "OAuthException",
"code": 131055,
"fbtrace_id": "AacMONwqoqRZJidqSa1LDey"
}
}
}
Using the wrong D360-API-KEY
If you use an invalid D360-API-KEY, the request will fail with an authentication error. This typically means the token is incorrect or missing.
{ "error": "Invalid api token." }
Examples using multiple programming languages
1. Postman Collection
This collection is designed to help you quickly test and validate MM Lite API behavior across a range of use cases.
How to use:
Import in Postman, the JSON file corresponding to a collection of requests with examples related with MM Lite API.
Modify the collection variables, with the values you received from 360Dialog Team.
2. NodeJS (using request library)
Set current Webhook URL
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://waba-v2.360dialog.io/waba_webhook',
'headers': {
'Content-Type': 'application/json',
'D360-API-KEY': '<token>'
},
body: JSON.stringify({
"url": "https://webhook.site/d4d4df6d-ee02-4572-a021-bcc60836d1e7"
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
See details in our documentation.
Send text message using Cloud API
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://waba-v2.360dialog.io/messages',
'headers': {
'Content-Type': 'application/json',
'D360-API-KEY': '<token>'
},
body: JSON.stringify({
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "<phone_number>",
"type": "text",
"text": {
"body": "This is a simple text msg send using cloud api"
}
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Once you’re approved to join the program, you can request a Postman collection that includes both successful request examples and the expected error responses by emailing .
