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

# Send

## Send

<mark style="color:green;">`POST`</mark> `https://sms.hollatags.com/api/send`

This endpoint allows you to send SMS Message

The **`POST`** parameters should be sent as **`x-www-form-urlencoded`**

#### Request Body

| Name                                   | Type    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| -------------------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| user<mark style="color:red;">\*</mark> | string  | Account username                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| pass<mark style="color:red;">\*</mark> | string  | Account password                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| from<mark style="color:red;">\*</mark> | string  | <p>SMS SenderID <br><code>must be <= 11 chars for alphanumerical</code><br><code>must be <= 16 chars for numerical</code></p>                                                                                                                                                                                                                                                                                                                                        |
| to<mark style="color:red;">\*</mark>   | string  | <p>Destination number(s)<br><code>(must be in international format and no prefix e.g 2348030000000)</code><br><br>Separate with comma if you are sending to multiple recipients (e.g 234805\*,234803\*)<br><br>The maximum limit on the API is currently 500 numbers for a single API call.</p>                                                                                                                                                                      |
| msg<mark style="color:red;">\*</mark>  | string  | <p>SMS Message Content<br><code>(Must be <=905 chars)</code></p>                                                                                                                                                                                                                                                                                                                                                                                                     |
| type                                   | integer | <p>Message Format<br><code>0 = Normal SMS</code><br><code>1 = Flash SMS</code><br><code>2 = Unicode SMS (Arabic, Chinese etc)</code></p>                                                                                                                                                                                                                                                                                                                             |
| callback\_url                          | string  | <p>If specified, sms status notifications would be sent to this URL by HTTP POST. You can include paths in the url but all query parameters are ignored. <br><br><code>See</code> <a href="/sms/callback.md"><code><https://docs.hollatags.com/send/callback></code></a><code>for a full list of message status parameters that will be sent back to your url.</code></p>                                                                                            |
| enable\_msg\_id                        | boolean | <p>If <strong>TRUE, the</strong> API response will contain a unique message\_id for your sms. <br><br>Sample response<br><em><code>2348030000000, 24137cf8-eccc-469c-80af-109538857e53</code></em><br><br>Tilde (~~) will be used to separate multiple destination numbers. e.g<br><br><code>2348030000000, 42138969-09f9-434d-a3c6-db5733fba736~~2348030000011,974790b3-e598-41a8-939b-772d16860fb4</code></p>                                                      |
| message\_uuid                          | string  | <p>This serves as the idempotency unique client message reference ID for safely retrying failed or timeout requests without accidentally executing the same transaction twice.<br></p><p>(automatically expire after 30days)<br>(Length is 24 to 64 characters )<br></p><p><code>We suggest the reference ID should be a V4 UUIDs (e.g 58c0d0f9-7dc6-4ce0-91ae-2d84c5880713), or another random string that can guarantee uniqueness to avoid collisions.</code></p> |

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

```
sent
```

{% endtab %}

{% tab title="ENABLE MESSAGE\_ID" %}

```php
23448030000000,24137cf8-eccc-469c-80af-109538857e53
```

{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}