Send Outbound SMS API¶

This API enables sending outbound SMS messages through the platform's generic SMS channel. The capability can be integrated into applications or services to facilitate SMS communication with customers.

Prerequisites¶

The SMS channel must be configured to send outbound SMS using this API. Learn more.
The phone number must be attached to an experience flow. Learn more.

Method	POST
Endpoints	`https://{{host}}/api/public/bot/{{BotId}}/outboundsms`
Content-Type	`application/json`
Authorization	`auth: {{JWT}}` See How to generate the JWT Token.
API Scope	Outbound SMS

Path Parameters¶

Parameter	Description	Type
host	Environment URL, for example, https://smartassist.kore.ai	string, required
BotId	BotId or StreamId. You can access it from the bot's General Settings page.	string, required

Sample Request¶

curl --location 'https://{{host}}/api/public/bot/st-26d52ba6-7a77-56b2-be4e-a8db1da7e440/outboundsms' \
--header 'Content-Type: application/json;charset=UTF-8' \
--header 'auth: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwiYXBwSWQiOiJjcy1kYzZlY2RmZC1jYmE3LTUwNTUtYTk4My1mZmZhMTE1NWEzZjUifQ.03LljsV8Not1NMbo-3Y-pJvNWjB6J8dTciPGPx-8h4Q' \
--data '{
    "fromNo": "+16693422058",
    "toNo": "+917760336484"
}'

Body Parameters¶

Parameter	Description	Type
fromNo	The sender's phone number in E.164 format. For example, +19876543210. \ Note: This number must be attached to an Experience Flow.	string, required
toNo	The recipient's phone number in E.164 format. For example, +911234567890	string, required

Sample Response¶

{
    "message": "Triggered the configured Experience flow to deliver message via SMS channel"
}