> For the complete documentation index, see [llms.txt](https://padiwise.gitbook.io/padiwise/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://padiwise.gitbook.io/padiwise/value-added-services/sms.md).

# SMS Gateway API

### Providers Validation

&#x20;<mark style="color:green;">`POST`</mark>  `{{ BASE }}/bulk-sms`

```
--header 'Accept: application/json'
--header 'Authorization: Bearer {{  access_token }}'
```

**Request Body**

Below are the request body parameters 🎉

| Name                 | Type   | Description                                                                                                                      |
| -------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------- |
| **sender\_name**     | String | The Sender ID is a maximum of 11 Characters                                                                                      |
| **recipient**        | Number | Recipient Number, the 'to' parameter can be in any of these formats 07037770033, 2347037770033, +2347037770033, +23407037770033. |
| **message**          | String |                                                                                                                                  |
| **reference**        | String | Unique id                                                                                                                        |
| **transaction\_pin** | Number | Padiwise 6 Digit Pincode                                                                                                         |

Response Body

```html
{
    "status": true,
    "message": "Message sent successfully. Note: you will be charged base on country code!",
    "data": {
        "verified": {{true}},
        "message": "{{message}}"
    }
}
```