Skip to main content

​
Introduction

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

​
Base URL

https://api.v7. Convertalk.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: 
jsonCopy code[
  {
    "profile": {
      "userDetails": {
        "userProvidedName": "User Name",
        "contact": {
          "email": "user@email.com",
          "phone": {
            "number": "1234567890",
            "prefix": "91"
          }
        },
        "tags": [],
        "attributes": []
      }
    }
  }
]

​
Example CURL Request

curl 'https://api.v7. Convertalk.com/inbox/users/import' \
  -H 'Authorization: Bearer eyJhbGciOiJSUzUxMiIsInR5cCI6IkpXVCJ9...' \
  -H 'Content-Type: application/json' \
  -H 'Accept: */*' \
  -H 'Origin: https://app. Convertalk.com' \
  -H 'Referer: https://app. Convertalk.com/' \
  -H 'Sec-Fetch-Dest: empty' \
  -H 'Sec-Fetch-Mode: cors' \
  -H 'Sec-Fetch-Site: same-site' \
  -H 'User-Agent: Your User-Agent' \
  --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

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

​
Conclusion

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

​
❓ 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@ Convertalk.com](mailto:support@ Convertalk.com).
⌘I