POST
/
v1
/
sms
/
send
Send SMS Message
curl --request POST \
  --url https://api.bland.ai/v1/sms/send \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '{
  "user_number": "<string>",
  "agent_number": "<string>",
  "agent_message": "<string>",
  "request_data": {}
}'
{
  "data": {
    "message": "SMS sent successfully",
    "conversation_id": "convo_abc123",
    "workflow_id": "workflow_xyz789"
  },
  "errors": null
}
Enterprise Feature - SMS is only available on Enterprise plans. Contact your Bland representative for access.

​
Headers

​
authorization
string
required
Your API key for authentication. Use the format: Bearer YOUR_API_KEY.

​
Body Parameters

​
user_number
string
required
The E.164 formatted phone number of the user receiving the message.
​
agent_number
string
required
The E.164 formatted phone number used to send the message (must belong to the authenticated account).
​
agent_message
string
required
The content of the SMS message to send.
​
request_data
object
Optional metadata to associate with the conversation or message. Used for custom routing or analytics.

​
Response

​
data
object
An object confirming the message was sent and referencing the triggered workflow.
​
data.message
string
Confirmation text for the successful send.
​
data.conversation_id
string
ID of the conversation that was created or resumed.
​
data.workflow_id
string
ID of the Temporal workflow triggered to process the message.
​
errors
null|array
null on success, or a list of error objects if the request failed.
{
  "data": {
    "message": "SMS sent successfully",
    "conversation_id": "convo_abc123",
    "workflow_id": "workflow_xyz789"
  },
  "errors": null
}