---
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`

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/sms-api-documentation.md) · [All operations](https://skmtc.dev/verihubs/apis/sms-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/verihubs/sms-api-documentation/revisions/5fa885d38adc/schema)