Skip to main content
POST
/
v1
/
sms
Send SMS
curl --request POST \
  --url https://api.unosend.co/v1/sms \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "to": "<string>",
  "template_id": "<string>",
  "body": "<string>",
  "sender_id": "<string>",
  "variables": {}
}
'
{
  "success": true,
  "data": {
    "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "status": "sent"
  }
}
​
to
string
required
Recipient phone number with country code. Example: "+19876543210".
​
template_id
string
required
Approved MSG91 template/flow ID. Get this from the Templates page after approval.
​
body
string
Optional message body for logging. If omitted, the template ID is stored as reference.
​
sender_id
string
Custom sender ID. Defaults to UNOSND if not provided.
​
variables
object
Key-value map of template variables. Keys must match ##variable## names in the template.

​
Response

​
id
string
Unique SMS message ID.
​
status
string
Delivery status: queued, sent, delivered, or failed.
{
  "success": true,
  "data": {
    "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "status": "sent"
  }
}