# 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”**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 

<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 %}