---
title: "Send WhatsApp Bulk Message V2"
method: POST
path: "/v2/whatsapp/message/bulk"
tags: ["WhatsApp Bulk Message"]
---

# Send WhatsApp Bulk Message V2

`POST /v2/whatsapp/message/bulk`

## Request

- Base URL: `https://api.verihubs.com`
- URL: `https://api.verihubs.com/v2/whatsapp/message/bulk`
- Auth: none declared. Required headers: `App-ID`, `API-Key`

This method allows you to broadcast WhatsApp message to multiple destination numbers. Maximum 5000 msisdn per bulk send.<br>

 **API Update Notice:** This V2 endpoint is the recommended version, replacing the previous V1 endpoint. We recommend migrating to V2 immediately for a better experience.<br>

  Benefits of V2:
  - Decreased processing time for API requests and responses
  - Improved features: Blocking Request, Spam Check, and Blocked Numbers
  - Increased RPS (from 30 RPS to 50 RPS)
  - Better developer environment to support future developments
  - Improved logging and monitoring
  - Improved dependencies and service stability<br>

  A rate limit of 50 RPS is applied to WhatsApp services. Verihubs also applies rate limits divided into several categories based on product. For more details, see [Rate Limit](https://docs.verihubs.com/docs/rate-limit).

## Headers

- `App-ID` string, required
- `API-Key` string, required

## Request body

- SendBulkMessage
  - `msisdn` string[], required: Destination phone number array, you must include international prefix number.
  - `content` ComponentParams[]: Content to fill variables on the tamplate, format must be in array of ComponentParams object or none (if template has no variable). If content is an array with only 1 ComponentParams object and there is more than 1 msisdn, the 1 ComponentParams object will be repeated for all msisdn.
    - `body_params` string[]
    - `header_params` string[]
    - `button_param` ButtonParam
      - `url_param` string
  - `template_name` string, required: Template name to be used.
  - `lang_code` string, required: Language code of the template to be used.
  - `callback_url` string: This URL will be called by Verihubs' server when an event occurs.

## Response `201`

Successful Response

- MessageHttpPublicApiSchemaResponseSuccessBulk
  - `code` 201: Code **(to be deleted on November 30, 2022)**
  - `status` 201: Status **(to be deleted on November 30, 2022)**
  - `message` string: Message
  - `msisdn` string[]: destination number list with international prefix country code

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `409`: Conflict
- `422`: Validation Error
- `429`: Too Many Requests

---

[API](https://skmtc.dev/verihubs/apis/whatsapp-api-documentation.md) - [All operations](https://skmtc.dev/verihubs/apis/whatsapp-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/verihubs/apis/whatsapp-api-documentation/revisions/7c709c17b600?raw)