> For the complete documentation index, see [llms.txt](https://partners.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://partners.botpenguin.com/api-documentation/contact-and-chat-apis/add-whatsapp-contact.md).

# Add WhatsApp Contact

### Introduction

The **Inbox User Import API** allows you to import WhatsApp contacts into the BotPenguin platform. You can use this API to create or update WhatsApp contacts with various attributes and contact information.

#### Base URL

```bash
https://api-v7.express-chat.com/inbox/users/import
```

### Authentication

To use this API, you need to include the following authentication header:

* **Authorization**: Bearer Token
* Example: `Bearer eyJhbGciO*****InR5cCI6IkpXVCJ9...`

### Request Headers

The following request headers are required:

* **Content-Type**: application/json

### Request Data

The request should include a JSON array of user profiles to be imported. Each user profile should have the following structure:

```json
jsonCopy code[
  {
    "profile": {
      "userDetails": {
        "userProvidedName": "User Name",
        "contact": {
          "email": "user@email.com",
          "phone": {
            "number": "1234567890",
            "prefix": "91"
          }
        },
        "tags": [],
        "attributes": []
      }
    }
  }
]
```

#### Example CURL Request

```bash
curl 'https://api-v7.express-chat.com/inbox/users/import' \
  -H 'Authorization: Bearer eyJhbGciOiJSUzUxMiIsInR5cCI6IkpXVCJ9...' \
  -H 'Content-Type: application/json' \
  -H 'Accept: */*' \
  -H 'Origin: https://app.eleapis.com/' \
  -H 'Referer: https://app.eleapis.com/' \
  -H 'Sec-Fetch-Dest: empty' \
  -H 'Sec-Fetch-Mode: cors' \
  -H 'Sec-Fetch-Site: same-site' \
  -H 'User-Agent: Your User-Agent' \
  -H 'authtype: Key' \
  --data-raw '[{"profile":{"userDetails":{"userProvidedName":"User Name","contact":{"email":"user@email.com","phone":{"number":"1234567890","prefix":"91"}},"tags":[],"attributes":[]}}}]' \
  --compressed
```

### Response

The API will respond with a status code and a JSON response body. The response body will contain information about the import operation.

* **Status Codes**:
  * `200 OK`: The import operation was successful.

#### Example Response

```json
jsonCopy code{
  "status": "success",
  "message": "User profiles imported successfully."
}
```

### Conclusion

The Inbox User Import API allows you to easily import user profiles into the BotPenguin platform. Make sure to follow the authentication and data format guidelines for successful imports.

### :question: Got any questions?

If you have any questions, you can look into our repository of FAQs, most likely, you will find your answer here, If not, write us at <support@botpenguin.com>


---

# 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://partners.botpenguin.com/api-documentation/contact-and-chat-apis/add-whatsapp-contact.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.