> For the complete documentation index, see [llms.txt](https://docs.oneroute.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.oneroute.io/sms-api/sms-api/send-sms-to-customers.md).

# Send SMS to Customers

## Send SMS to Customers

<mark style="color:green;">`POST`</mark> `https://api.oneroute.io/api/public/channel/:id/sms`

#### Path Parameters

| Name                                 | Type   | Description       |
| ------------------------------------ | ------ | ----------------- |
| id<mark style="color:red;">\*</mark> | string | id of the channel |

#### Headers

| Name                                     | Type   | Description                 |
| ---------------------------------------- | ------ | --------------------------- |
| apiKey<mark style="color:red;">\*</mark> | string | API key for authentication. |

#### Request Body

| Name          | Type   | Description                                                                         |
| ------------- | ------ | ----------------------------------------------------------------------------------- |
| message       | string | The message to send to the customers                                                |
| recipients    | array  | List of recipients phone numbers                                                    |
| recipients.\* | string | recipient phone number. Must be in international format (Example: `2341793026727`). |

### Request Payload

```json
{
    "message": "message content",
    "recipients": ["23490xxxxxxxx"]
}
```

### Response

{% tabs %}
{% tab title="200" %}

```json
{
    "body": [
        {
            "status": "success",
            "response": "4744271336207951463605"
        }
    ],
    "message": "SMS processed successfully",
    "success": true
}
```

{% endtab %}
{% endtabs %}