---
title: "Send Bulk SMS V2"
method: POST
path: "/v2/sms/bulk"
tags: ["SMS Notifications and Promotions"]
---
# Send Bulk SMS V2
`POST /v2/sms/bulk`
## Request
- Base URL: `https://api.verihubs.com`
- URL: `https://api.verihubs.com/v2/sms/bulk`
- Auth: none declared. Required headers: `App-ID`, `API-Key`
SMS OTP version change is by introducing a new API version release.
Version changes usually need to be applied immediately to the latest version, in order to get a better API usage experience than the previous version.
The benefits you get if you use a newer version are as follows.
- Decreasing processing time in API Request and Response
- Improve feature in SMS: Blocking Request, Spam Check, Sequential Phone Number, and Blocked Numbers
- Increase RPS in SMS (before 30rps to 50rps)
- Better developer environment to support future developments
- Improve logging and monitoring on our side
- Improved dependencies and improved service stability
This method helps you to send sms containing desired text to destination number
Rate limit of 50 RPS is applied to SMS service. Verihubs also apply rate limit divided into several categories based on product. More explanation [link](https://docs.verihubs.com/docs/rate-limit)
#### Callback Description
When you want to use callback_url payload, you only need to put for example
```
your-callback-url.com/callback
```
Example callback that we'll send
```
your-callback-url.com/callback?session_id=d0f5fb5c-2d50-4d3f-aea7-20018ab15806&status=1
```
Payload | Description |
-----------|:---------------------|
session_id | ID of the specific message |
status | Latest status of the request |
#### Status Description
Status | Name | Description |
-----------|:---------------------|:-------------------------- |
0 | Requested | SMS has been requested. |
1 | Delivered | SMS has been delivered to destination number. This status will be charged. |
4 | Failed | Operator cannot send SMS to destination number |
5 | Request Error | Verihubs cannot reach Operator |
7 | Undelivered | SMS has not been delivered to destination number (response received from Operator). This status will be charged. |
8 | No Delivery Report | Delivered without Delivery Report from operator after certain period. This status will be charged. |
9 | Blocked | Destination Number has been blocked by Verihubs's system |
## Headers
- `App-ID` string, required
- `API-Key` string, required
## Request body
- SendBulkSms
- `msisdn` string[], required: Destination Phone Number. You need to include the international prefix number and also find your local prefix number [here.](https://docs.verihubs.com/docs/supported-local-operator-prefix)
- `text` string[], required: SMS Body. In the SMS Body, you must mention the brand name according to the Sender ID. If list is used, please make sure text list equal to msisdn list because the text will be sent based on the same row as msisdn.
- `premium` boolean: used for Transactional SMS (Text Message from Business to Customer that provides valuable information about their product, service or processes).
- `callback_url` string: Optional. This URL will be called by the server when the desired event will occur. Callback will work if you use premium route
## Response `201`
Successful Response
- ResponseSendBulkSms
- `message` string, required: Message
- `msisdn` string[], required: Destination number with international prefix country code.
- `session_id` string: Generated ID which associated with verification request.
## Other responses
- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `409`: Conflict
- `429`: Too Many Requests
- `500`: Internal Server Error
## Changes
- **2026-11-03** `c1a5653952bb`: 1 info
- endpoint added
[Operation history](https://skmtc.dev/verihubs/apis/sms-api-documentation/changes/v2/sms/bulk/post.md)
---
[API](https://skmtc.dev/verihubs/apis/sms-api-documentation.md) - [All operations](https://skmtc.dev/verihubs/apis/sms-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/verihubs/apis/sms-api-documentation/revisions/c1a5653952bb?raw)