# Sending Bulk Messages - Push

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”**&#x76;ariable
{% 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&#x20;

<mark style="color:green;">`POST`</mark> `https://pickyassist.com/app/api/v2/push`

This API allows you to send Bulk Messages&#x20;

### 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 | <p>Specify through which application the message need to sent.<br><br>1 = Whatsapp Personal<br>2 = Whatsapp Business<br>3 = SMS<br>4 = Call Conference<br>8 = WhatsApp Official<br>10 = WhatsApp Web Automation<br>101 = WhatsApp Managed Service</p><p>121 = WhatsApp Official Managed<br>101 = WhatsApp Cloud API<br><br><strong>If you have connected multiple channels or using WhatsApp Cloud api then please get the channel id from your project under Settings -></strong> <a href="https://pickyassist.com/app/settings/channels">Channels </a></p> |
| globalmessage | string | <p>Global Message Text Message with emoji supported by whatsapp<br><br><em>If you are sending image and video you can pass caption text here</em></p>                                                                                                                                                                                                                                                                                                                                                                                                        |
| globalmedia   | string | URL from we need to fetch the media , **Maximum Size is 50 MB**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| priority      | string | <p>This gives priority  in the message queue <br><br>0 = Low (Default) <br>1 = High</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| data          | array  | This is an array in which you need to pass the mobile number and message                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| number        | number | <p>Mobile Number with full country code <em><strong>without 0 or +</strong></em> <br><br><del>+55 12345 6789</del> – Wrong Format<br><strong>55123456789 – Correct Format</strong></p>                                                                                                                                                                                                                                                                                                                                                                       |
| message       | string | <p>Text Message with emoji supported by whatsapp If you are sending image and video you can pass caption text also here. <br><br><strong>Caption text is not supported for PDF, Audio, Document</strong></p>                                                                                                                                                                                                                                                                                                                                                 |

{% 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: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.pickyassist.com/api-documentation-v2/push-api/sending-bulk-messages-push.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
