Send Template with Body + Header Variables
Send a template message with both body and header dynamic variables.
Authorization
ApiKeyAuth API key from your dashboard (Settings > API Keys)
In: header
Header Parameters
Optional. Attribute this send to a specific agent, overriding the agent bound to the API key. The agent must belong to your account and be active (role AGENT, parent = your account) — otherwise the request returns 400. Drives customer assignment, agent allotment limits, and the wallet ledger entry.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://loading/api/v1/messages/send#template-body-header-vars" \ -H "X-AGENT-ID: agt_abc123" \ -H "Content-Type: application/json" \ -d '{ "to": "919876543210", "message": { "message_type": "template", "template_name": "delivery_update", "template_language": "en_US", "header_variables": [ "ORD-12345" ], "body_variables": [ "John", "March 15, 2026", "2:00 PM - 4:00 PM" ] } }'{
"success": true,
"data": {
"id": "clx9abc123def456"
}
}{
"success": false,
"message": "to field is required"
}{
"success": false,
"message": "user not authenticated"
}{
"success": false,
"message": "insufficient balance to send message"
}{
"success": false,
"message": "template not found"
}{
"success": false,
"message": "internal server error"
}Send Template (Basic) POST
Send a pre-approved WhatsApp template message with no dynamic variables or attachments. Just the template name and language.
Send Template with Body Variables POST
Send a template message with dynamic body variables. Variables are substituted into the template body in order (`{{1}}`, `{{2}}`, etc.).