> 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

Our Bulk SMS Gateway API allows you to integrate your Padiwise account with your application or website. This could be used for sending OTPs (One Time Passwords), Transactional SMS, e.t.c

### 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}}"
    }
}
```