> For the complete documentation index, see [llms.txt](https://help.pickyassist.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.pickyassist.com/api-documentation-v2/push-api/sending-contacts.md).

# Sending Contacts

This method helps you to send single or multiple contacts 

{% hint style="danger" %}
**Not Supported in Phone Automation**
{% endhint %}

## Sending Contacts

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

This API allows you to send one or multiple contacts to one or multiple numbers.

### 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>8 = WhatsApp Official<br>10 = WhatsApp Web Automation<br>121 = WhatsApp Official Managed<br>101 = WhatsApp Cloud API<br><br>If you have connected multiple channels or using WhatsApp Cloud api then please get the channel id from your project under Settings -> Channels</p> |
| data           | array  | This is an array where you need to pass the mobile number                                                                                                                                                                                                                          |
| number         | number | <p>Mobile Number with full country code without 0 or +<br><br><del>+55 12345 6789 – Wrong Format</del> 55123456789 – Correct Format</p>                                                                                                                                            |
| contact        | array  | This is an array in which you need to pass contact value                                                                                                                                                                                                                           |
| first\_name    | string | First name of the contact                                                                                                                                                                                                                                                          |
| phone          | number | Phone number of the contact with country code                                                                                                                                                                                                                                      |
| last\_name     | string | Last Name                                                                                                                                                                                                                                                                          |
| city           | string | City                                                                                                                                                                                                                                                                               |
| country        | string | Country                                                                                                                                                                                                                                                                            |
| country\_code  | string | Country Code                                                                                                                                                                                                                                                                       |
| state          | string | State                                                                                                                                                                                                                                                                              |
| street         | string | Street Address                                                                                                                                                                                                                                                                     |
| address\_type  | string | Address Type like Work, Office                                                                                                                                                                                                                                                     |
| zip            | number | Postal Code                                                                                                                                                                                                                                                                        |
| email          | string | Email                                                                                                                                                                                                                                                                              |
| company        | string | Company name                                                                                                                                                                                                                                                                       |
| contact\_image | string | Base 64 code of the contact image                                                                                                                                                                                                                                                  |

{% tabs %}
{% tab title="200 " %}

```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":"78a2c87687a11f54b83fd1a017f05eb6794",
   "application":"8",
   "data":[ 
      { 
         "number":"919442222222",
         "message":""
      }
   ],
   "contact":[ 
      { 
         "city":"",
         "country":"India",
         "country_code":"in",
         "state":"Delhi",
         "street":"",
         "address_type":"Home",
         "zip":"",
         "email":"test@gmail.com",
         "first_name":"Test",
         "last_name":"User",
         "phone":"+91 99999 00111",
         "phone_type":"Mobile",
         "company":"Picky Assist"
      },
      { 
         "city":"",
         "country":"USA",
         "country_code":"in",
         "state":"Dehi",
         "street":"",
         "address_type":"Office",
         "zip":"",
         "email":"contact@gmail.com",
         "first_name":"User",
         "last_name":"Test",
         "phone":"+91 98888 00222",
         "phone_type":"Mobile",
         "company":"Picky Assist"
      }
   ]
}
```

## 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"
        }
    ]
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.pickyassist.com/api-documentation-v2/push-api/sending-contacts.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.