> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Send Outbound SMS

<Badge icon="arrow-left" color="gray">[Back to API List](/ai-for-service/apis/contact-center/api-list)</Badge>

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](/ai-for-service/channels#digital-channels).
* The phone number must be attached to an experience flow. [Learn more](/ai-for-service/flows/create-and-manage-flows#sms-channel).

| Method            | POST                                                                                                                            |
| :---------------- | :------------------------------------------------------------------------------------------------------------------------------ |
| **Endpoint**      | `https://{{host}}/api/public/bot/{{BotId}}/outboundsms`                                                                         |
| **Content-Type**  | `application/json`                                                                                                              |
| **Authorization** | `auth: {{JWT}}` See [How to generate the JWT Token](/ai-for-service/apis/automation/api-introduction#generating-the-jwt-token). |
| **API Scope**     | Outbound SMS                                                                                                                    |

## Path Parameters

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

## Sample Request

```bash theme={null}
curl --location 'https://{{host}}/api/public/bot/st-26d52ba6-7a77-56b2-be4e-a8db1da7e440/outboundsms' \
--header 'Content-Type: application/json;charset=UTF-8' \
--header 'auth: <token>' \
--data '{
    "fromNo": "+19876543210",
    "toNo": "+911234567890"
}'
```

## Body Parameters

| Parameter | Description                                                                                                    | Type             |
| :-------- | :------------------------------------------------------------------------------------------------------------- | :--------------- |
| `fromNo`  | The sender's phone number in E.164 format. For example, +19876543210. Attach the number to an Experience Flow. | string, required |
| `toNo`    | The recipient's phone number in E.164 format. For example, +911234567890                                       | string, required |

## Sample Response

```json theme={null}
{
    "message": "Triggered the configured Experience flow to deliver message via SMS channel"
}
```