Send SMS Message

curl --request POST \
  --url https://api-ai.zixflow.com/api/ingest/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>"
}
'

import requests

url = "https://api-ai.zixflow.com/api/ingest/sms/v1/message/send"

payload = {
    "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>"
}
headers = {
    "x-api-key": "<x-api-key>",
    "x-workspace-id": "<x-workspace-id>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-api-key': '<x-api-key>',
    'x-workspace-id': '<x-workspace-id>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    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>'
  })
};

fetch('https://api-ai.zixflow.com/api/ingest/sms/v1/message/send', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-ai.zixflow.com/api/ingest/sms/v1/message/send",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <x-api-key>",
    "x-workspace-id: <x-workspace-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-ai.zixflow.com/api/ingest/sms/v1/message/send"

	payload := strings.NewReader("{\n  \"recipient\": \"<string>\",\n  \"message\": \"<string>\",\n  \"sender_id\": \"<string>\",\n  \"route\": \"<string>\",\n  \"is_flash\": true,\n  \"dlt_entity_id\": \"<string>\",\n  \"dlt_template_id\": \"<string>\",\n  \"post_back_url\": \"<string>\",\n  \"post_back_data\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<x-api-key>")
	req.Header.Add("x-workspace-id", "<x-workspace-id>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api-ai.zixflow.com/api/ingest/sms/v1/message/send")
  .header("x-api-key", "<x-api-key>")
  .header("x-workspace-id", "<x-workspace-id>")
  .header("Content-Type", "application/json")
  .body("{\n  \"recipient\": \"<string>\",\n  \"message\": \"<string>\",\n  \"sender_id\": \"<string>\",\n  \"route\": \"<string>\",\n  \"is_flash\": true,\n  \"dlt_entity_id\": \"<string>\",\n  \"dlt_template_id\": \"<string>\",\n  \"post_back_url\": \"<string>\",\n  \"post_back_data\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-ai.zixflow.com/api/ingest/sms/v1/message/send")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["x-workspace-id"] = '<x-workspace-id>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"recipient\": \"<string>\",\n  \"message\": \"<string>\",\n  \"sender_id\": \"<string>\",\n  \"route\": \"<string>\",\n  \"is_flash\": true,\n  \"dlt_entity_id\": \"<string>\",\n  \"dlt_template_id\": \"<string>\",\n  \"post_back_url\": \"<string>\",\n  \"post_back_data\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "SMS request queued successfully",
  "request_id": "f8df74d1-11fa-4485-b164-b9a65358f4fc"
}

{
  "success": false,
  "message": "Invalid data provided"
}

{
  "success": false,
  "message": "Unauthorised"
}

POST

api

ingest

sms

message

send

Send SMS Message

curl --request POST \
  --url https://api-ai.zixflow.com/api/ingest/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>"
}
'

import requests

url = "https://api-ai.zixflow.com/api/ingest/sms/v1/message/send"

payload = {
    "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>"
}
headers = {
    "x-api-key": "<x-api-key>",
    "x-workspace-id": "<x-workspace-id>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-api-key': '<x-api-key>',
    'x-workspace-id': '<x-workspace-id>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    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>'
  })
};

fetch('https://api-ai.zixflow.com/api/ingest/sms/v1/message/send', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-ai.zixflow.com/api/ingest/sms/v1/message/send",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <x-api-key>",
    "x-workspace-id: <x-workspace-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-ai.zixflow.com/api/ingest/sms/v1/message/send"

	payload := strings.NewReader("{\n  \"recipient\": \"<string>\",\n  \"message\": \"<string>\",\n  \"sender_id\": \"<string>\",\n  \"route\": \"<string>\",\n  \"is_flash\": true,\n  \"dlt_entity_id\": \"<string>\",\n  \"dlt_template_id\": \"<string>\",\n  \"post_back_url\": \"<string>\",\n  \"post_back_data\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<x-api-key>")
	req.Header.Add("x-workspace-id", "<x-workspace-id>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api-ai.zixflow.com/api/ingest/sms/v1/message/send")
  .header("x-api-key", "<x-api-key>")
  .header("x-workspace-id", "<x-workspace-id>")
  .header("Content-Type", "application/json")
  .body("{\n  \"recipient\": \"<string>\",\n  \"message\": \"<string>\",\n  \"sender_id\": \"<string>\",\n  \"route\": \"<string>\",\n  \"is_flash\": true,\n  \"dlt_entity_id\": \"<string>\",\n  \"dlt_template_id\": \"<string>\",\n  \"post_back_url\": \"<string>\",\n  \"post_back_data\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-ai.zixflow.com/api/ingest/sms/v1/message/send")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["x-workspace-id"] = '<x-workspace-id>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"recipient\": \"<string>\",\n  \"message\": \"<string>\",\n  \"sender_id\": \"<string>\",\n  \"route\": \"<string>\",\n  \"is_flash\": true,\n  \"dlt_entity_id\": \"<string>\",\n  \"dlt_template_id\": \"<string>\",\n  \"post_back_url\": \"<string>\",\n  \"post_back_data\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "SMS request queued successfully",
  "request_id": "f8df74d1-11fa-4485-b164-b9a65358f4fc"
}

{
  "success": false,
  "message": "Invalid data provided"
}

{
  "success": false,
  "message": "Unauthorised"
}

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

string

required

Your API key for authentication.

string

required

Your workspace ID for authentication.

Body

string

required

The phone number with a country prefix to which the message will be sent. Required. Must be in international format without the leading plus sign (+) or any spaces, dashes, or other special characters. Format: country code followed by the phone number. Example: 919876543210 (India: country code 91 + number 9876543210).

string

required

The content of the message that you want to send.

string

required

The registered and approved sender name to be used for the message. You can add and manage sender IDs in Zixflow SMS Settings.

string

required

Type of connectivity for the message. Supported routes: promotional, transactional, or otp.

boolean

Set this parameter to true if you want to send a flash SMS via the API; otherwise, set it to false. Flash SMS appears directly on the screen. Default: false.

string

Only applicable for India. If you want to pass a DLT entity ID directly via the API, you can do so with this parameter. DLT (Distributed Ledger Technology) entity ID for compliance purposes.

string

Only applicable for India. If you want to pass a DLT template ID directly via the API, you can do so with this parameter. This is specifically for DLT (Distributed Ledger Technology) compliance purposes in India.

string

To receive post-back notifications about the sent message as it is delivered or failed. When a message status changes (delivered, failed, etc.), a notification will be sent to this URL. See Postback Notifications for the payload format and field descriptions.

string

The data that will be sent back on the post_back_url with the notification. This can be used as an identifier for the sent message if the client wants to track or correlate messages with their own system. See Postback Notifications for how it appears in the notification.

Response

boolean

Indicates whether the request was successful. true if the request was accepted and queued, false otherwise.

string

Success message when the request succeeded, or error message when it failed.

string

Present only when success is true. Unique identifier for this request; use it for tracking and for correlating with postback notifications.

{
  "success": true,
  "message": "SMS request queued successfully",
  "request_id": "f8df74d1-11fa-4485-b164-b9a65358f4fc"
}

{
  "success": false,
  "message": "Invalid data provided"
}

{
  "success": false,
  "message": "Unauthorised"
}

Send RCS Document Message Send Email Message

Zixflow AI

Sendflow

Events

WhatsApp

RCS

SMS

Email

Delivery Report

Send SMS Message

Description

Headers

Body

Response

​Description

​Headers

​Body

​Response

Description

Headers

Body

Response