> For the complete documentation index, see [llms.txt](https://help.pickyassist.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.pickyassist.com/api-documentation-v2/push-api/sending-bulk-messages-push.md).
# Sending Bulk Messages - Push
Send 100 of message in a single api call
If you wish to send same content to many numbers through a single API like message is static and numbers are different for example a promotion message which need to send to 100+ users etc then use the below method ;
{% hint style="info" %}
Leave individual **“message”** variable blank, and pass your message content in **“globalmessage”**variable
{% endhint %}
{% hint style="danger" %}
**We highly recommend to use this method rather than calling the single API 10 times and which increase your phone / docker load and slow down the message processing speed.**
{% endhint %}
## Sending Bulk Messages
`POST` `https://pickyassist.com/app/api/v2/push`
This API allows you to send Bulk Messages
### Request URL (V4)
Method : **`POST`**
```
https://app.pickyassist.com/api/v2/push
```
#### Request Body
| Name | Type | Description |
| ------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| token | string | Your API Token for authentication |
| application | number | Specify through which application the message need to sent.
1 = Whatsapp Personal
2 = Whatsapp Business
3 = SMS
4 = Call Conference
8 = WhatsApp Official
10 = WhatsApp Web Automation
101 = WhatsApp Managed Service
121 = WhatsApp Official Managed
101 = WhatsApp Cloud API
If you have connected multiple channels or using WhatsApp Cloud api then please get the channel id from your project under Settings -> Channels
|
| globalmessage | string | Global Message Text Message with emoji supported by whatsapp
If you are sending image and video you can pass caption text here
|
| globalmedia | string | URL from we need to fetch the media , **Maximum Size is 50 MB** |
| priority | string | This gives priority in the message queue
0 = Low (Default)
1 = High
|
| data | array | This is an array in which you need to pass the mobile number and message |
| number | number | Mobile Number with full country code without 0 or +
+55 12345 6789 – Wrong Format
55123456789 – Correct Format
|
| message | string | Text Message with emoji supported by whatsapp If you are sending image and video you can pass caption text also here.
Caption text is not supported for PDF, Audio, Document
|
{% tabs %}
{% tab title="200 Please note “100 -> Sucess” response doesn’t means the message has been successfully send to the user, it means your message has been accepted by our servers and pushed to your phone / app / docker for processing.
" %}
```javascript
{
"status": 100,
"push_id": "7478630",
"message": "Success",
"data": [
{
"msg_id": "9844217",
"number": "934343442290",
"credit": "0.005"
},
{
"msg_id": "9844218",
"number": "35435304220",
"credit": "0.005"
}
]
}
```
{% endtab %}
{% endtabs %}
## Sample Request Body JSON
```javascript
{
"token": "PICKY_API_TOKEN",
"priority ": "0",
"application": "1",
"globalmessage": "",
"globalmedia": "MEDIA FILE UNIQUE URL",
"data": [
{
"number": "NUMBER 1",
"message": "MESSAGE FOR NUMBER 1"
},
{
"number": "NUMBER 2",
"message": "MESSAGE FOR NUMBER 2"
},
{
"number": "NUMBER 3",
"message": "MESSAGE FOR NUMBER 3"
},
{
"number": "NUMBER 4",
"message": "MESSAGE FOR NUMBER 4"
},
{
"number": "NUMBER 5",
"message": "MESSAGE FOR NUMBER 5"
}
]
}
```
## Sample Response
```javascript
{
"status": 100,
"push_id": "7478630",
"message": "Success",
"data": [
{
"msg_id": "9844217",
"number": "934343442290",
"credit": "0.005"
},
{
"msg_id": "9844218",
"number": "35435304220",
"credit": "0.005"
}
]
}
```
{% hint style="info" %}
Please note **“100 -> Sucess”** response doesn’t means the message has been successfully send to the user, it means your message has been accepted by our servers and pushed to your phone / docker /app for processing.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://help.pickyassist.com/api-documentation-v2/push-api/sending-bulk-messages-push.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.