API reference

Send from the API

An approved template, or free-form text inside the 24-hour window.

POST /api/v1/messages sends on the number connected to the workspace.

Name	Type	Description
to	string, required	Phone in E.164 format
template	string	Approved template name
params	array	Values for template variables
text	string	Free-form text, 24-hour window only

curl "$APP_URL/api/v1/messages" \
  -H "Authorization: Bearer $ZYPTOS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+919800000099",
    "template": "order_update",
    "params": ["Asha", "Out for delivery"]
  }'

The response is { "id": "msg_…", "status": "queued" }.

Estimate first with POST /api/v1/messages/estimate and { "category": "utility", "recipients": 100 }. The amount is Meta’s rate times recipients.