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

# Send SMS

To send an SMS, make a <mark style="color:yellow;">`POST`</mark> request to this endpoint, passing an array of `phoneNumbers` and the `message` to send in the request body.

A successful request returns a status confirming the operation succeeded.

This process allows you to send SMS notifications to one or more recipients; for example, `transaction alerts`, `OTPs`, or `account notifications.`

<mark style="color:yellow;">`POST`</mark> `/api/Operations/v1/SendSMS`

**Headers**

| Name                                                | Value              | Description                                 |
| --------------------------------------------------- | ------------------ | ------------------------------------------- |
| Content-Type<mark style="color:red;">\*</mark>      | `application/json` | Format of the request payload               |
| request-reference<mark style="color:red;">\*</mark> | `unique_string`    | A unique reference identifying this request |

**Body Parameters**

<table><thead><tr><th>Name</th><th>Data Type</th><th data-type="checkbox">Required</th><th>Description</th></tr></thead><tbody><tr><td><code>phoneNumbers</code></td><td>array of strings</td><td>true</td><td>List of phone numbers to send the SMS to</td></tr><tr><td><code>message</code></td><td>string</td><td>true</td><td>The SMS message content</td></tr></tbody></table>

**Body table**

| Field     | Data Type | Description                           |
| --------- | --------- | ------------------------------------- |
| `status`  | boolean   | Whether the SMS was sent successfully |
| `message` | string    | Response message from the operation   |

Here is an example request and response with a sample payload sent to the endpoint in Curl format.

<details>

<summary>Sample Request</summary>

```json
curl --location -g '{{baseurl}}/api/Operations/v1/SendSMS' \
--header 'Content-Type: application/json' \
--header 'request-reference: unique_string' \
--data '{
    "phoneNumbers": ["2347080806848"],
    "message": "Testing"
}'
```

</details>

<details>

<summary>Response : <code>200</code></summary>

```
{
  "status": true,
  "message": "Operation Successful"
}
```

</details>