POST
/
v1
/
sms
/
create
Create SMS Conversation
curl --request POST \
  --url https://api.bland.ai/v1/sms/create \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '{
  "user_number": "<string>",
  "agent_number": "<string>",
  "message": "<string>",
  "message_sid": "<string>",
  "curr_pathway_id": "<string>",
  "curr_pathway_version": "<string>",
  "current_node_id": "<string>",
  "request_data": {},
  "new_conversation": true,
  "sender": "<string>"
}'
{
  "data": {
    "message": "SMS conversation created successfully",
    "conversation_id": "conv_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.

​
Body Parameters

​
user_number
string
required
The E.164 formatted phone number of the user in the conversation.
​
agent_number
string
required
The E.164 formatted phone number used by the agent (must belong to the authenticated account).
​
message
string
required
The content of the message to be stored in the conversation history.
​
message_sid
string
Optional Twilio message SID for tracking and correlation purposes.
​
curr_pathway_id
string
The UUID of the current pathway being used in this conversation.
​
curr_pathway_version
string
The specific version of the pathway to use (e.g., “latest”, “v1.0”).
​
current_node_id
string
The ID of the current node in the conversational pathway where this conversation is positioned.
​
request_data
object
Optional metadata to associate with the conversation. Used for custom routing or analytics.
​
new_conversation
boolean
When set to true, forces creation of a new conversation, archiving any existing active conversation between these numbers.
​
sender
string
Specifies who sent this message. Allowed values: “USER” or “AGENT”. Defaults to “USER” if not specified.

​
Response

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