Skip to main content
POST
https://api-ai.zixflow.com
/
api
/
ingestion
/
sms
/
v1
/
message
/
send
Send SMS Message
curl --request POST \
  --url https://api-ai.zixflow.com/api/ingestion/sms/v1/message/send \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-workspace-id: <x-workspace-id>' \
  --data '
{
  "recipient": "<string>",
  "message": "<string>",
  "sender_id": "<string>",
  "route": "<string>",
  "is_flash": true,
  "dlt_entity_id": "<string>",
  "dlt_template_id": "<string>",
  "post_back_url": "<string>",
  "post_back_data": "<string>"
}
'
{
  "status": true,
  "message": "SMS sent successfully"
}

​
Description

This endpoint allows you to send an SMS message to a recipient. You can specify the sender ID, route, and include DLT (Distributed Ledger Technology) information for compliance.

​
Headers

​
x-api-key
string
required
Your API key for authentication.
​
x-workspace-id
string
required
Your workspace ID for authentication.

​
Body

​
recipient
string
required
The phone number of the recipient in international format (e.g., “919876543210”).
​
message
string
required
The plain text content of the SMS message.
​
sender_id
string
The sender ID to display on the recipient’s phone. If not provided, a default sender ID will be used.
​
route
string
The SMS route to use for sending. Options may include promotional, transactional, etc.
​
is_flash
boolean
Whether to send as a flash SMS. Flash SMS appears directly on the screen without saving. Default: false
​
dlt_entity_id
string
DLT (Distributed Ledger Technology) entity ID for compliance purposes.
​
dlt_template_id
string
DLT template ID for compliance purposes.
​
post_back_url
string
Optional URL to receive post-back notifications about the SMS status.
​
post_back_data
string
Optional data to include in post-back notifications.

​
Response

​
status
boolean
Indicates whether the call was successful. true if successful, false if not.
​
message
string
Success or error response message.
{
  "status": true,
  "message": "SMS sent successfully"
}