# Sending Dynamic Messages – Push

If you wish to send different message contents (personalised messages) to different numbers through a single API call like sending bill alerts , customised reminders , absentees list, personalised greetings etc then please follow the below method; 

{% hint style="info" %}
Leave **“globalmessage”** variable as blank
{% endhint %}

{% hint style="info" %}
Pass each message to be send in the **“message”** variable  against each number
{% 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 Dynamic Message 

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

This API allows you to send Dynamic  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</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 / docker / app  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="warning" %}
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 %}