POST

Bulk Import Contacts

High Throughput

Imports up to 5,000 contacts in a single asynchronous batch operation.

HTTP Endpoint

POSThttps://api-wa.hidessh.com/api/v1/contacts/bulk

Authentication

This endpoint requires Bearer authentication via your secret API Key.

Header Key	Value	Required
Authorization	Bearer <your_api_key>	Required
Content-Type	application/json	Required

Request Parameters

The request body must be formatted as JSON with the following parameters:

Parameter	Type	Required	Description
`contacts`	array	Required	Array of contact objects (name, phone, tags, custom_fields).
`contacts[].name`	string	Required	Contact name.
`contacts[].phone`	string	Required	Contact phone in E.164 format.

Code Examples

request.sh

curl -X POST "https://api-wa.hidessh.com/api/v1/contacts/bulk" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contacts": [
      { "name": "Alice", "phone": "628111111111" },
      { "name": "Bob", "phone": "628222222222" }
    ]
  }'

Response Formats

Bulk import queued.

application/json • 200 OK

{
  "success": true,
  "message": "imported 2 contacts successfully"
}

On this page