# Sending Single Message - Push

Below is the Sample Push API Request & Response for sending WhatsApp & SMS , please update variables with your own values ;

## Sending Single Message&#x20;

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

This API allows you to send a Single Message&#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 (Phone Automation)<br>2 = WhatsApp Business (Phone Automation)<br>3 = SMS (Phone Automation)<br>4 = Call (Phone Automation)<br>5 = Facebook Messenger<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><br></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 ,                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| 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 POST Method

```javascript
{
  "token": "YOUR_API_TOKEN",
  "priority ": "0",
  "application": "10",
  "globalmessage": "your global message ",
  "globalmedia": "MEDIA FILE UNIQUE URL",
  "data": [
    {
      "number": "NUMBER 1",
      "message": "MESSAGE FOR NUMBER 1",
      "reference_number": "Your Internal Reference Number"
      
    },
    {
      "number": "NUMBER 2",
      "message": "MESSAGE FOR NUMBER 2",
      "reference_number": "Your Internal Reference Number"
      
    }
  ]
}
```

## Sample Request Normal POST Method

This is a normal post method and useful for those who would like to use the API as Webhook for various 3rd party applications like Zoho CRM, Zapier which don't directly support JSON POST method, you can post the message into a variable `"data"` as shown below&#x20;

**<https://pickyassist.com/app/api/v2/push?data=JSON>**

```javascript
{
  "token": "YOUR_API_TOKEN",
  "priority ": "0",
  "application": "1",
  "globalmessage": "your global message ",
  "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-single-message-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.
