Send a template message
POST/v1/messagesNeeds Idempotency-Key
Sends an approved Authentication or Utility template to one number, with a value for each variable: a login code, for example, or a report with a link to its PDF. The message is queued at once, and its status follows by the status webhook or from GET /v1/messages/{id}. Marketing templates can't be sent through the API yet.
curl -X POST "https://api.baatzo.com/v1/messages" \
-H "Authorization: Bearer $BAATZO_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"to": "+919876543210",
"template": {
"name": "fee_reminder",
"language": "en",
"variables": {
"parent_name": "Priya Mehta",
"amount": "₹4,500",
"month": "December",
"due_date": "5 Dec"
}
}
}'{
"id": "01937a2e-5c41-7d3a-8f2b-6e9c4a1d0b57",
"status": "queued",
"to": "+919876543210",
"template": {
"name": "fee_reminder",
"language": "en",
"category": "utility"
},
"created_at": "2026-12-01T03:30:00Z"
}