POST

Round-Robin Multi-Device Sending

Smart Pool

Automatically load-balances outbound messages across a pool of connected devices to bypass single-number limits, prevent bans, and achieve high delivery throughput.

Multi-Device Load Distribution

By setting `device_id: 'auto'` or omitting it, the queue worker dynamically routes messages across healthy connected devices.

HTTP Endpoint

POSThttps://api-wa.hidessh.com/api/v1/wa/messages/send

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
`phone`	string	Required	Target phone number in international E.164 format. example: 628987654321
`message`	string	Required	Message content. example: Your daily report is ready to download.
`device_id`	string	Optional	Set to 'auto' to trigger round-robin across all active devices in your tenant. default: "auto"example: auto
`simulate_typing`	boolean	Optional	Simulate typing status before sending. default: trueexample: true

Code Examples

request.sh

curl -X POST "https://api-wa.hidessh.com/api/v1/wa/messages/send" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "628987654321",
    "message": "Your automated report is ready for viewing.",
    "device_id": "auto",
    "simulate_typing": true
  }'

Response Formats

Message dispatched via optimal device from pool.

application/json • 200 OK

{
  "messaging_product": "whatsapp",
  "contacts": [{ "input": "628987654321", "wa_id": "628987654321" }],
  "messages": [{ "id": "3EB09876543210AB" }]
}

On this page