# 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;&#x20;

{% 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&#x20;

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


---

# 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-dynamic-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.
