WahideAPI Docs
POST

Pair Device (QR Code)

Initiates Multi-Device WhatsApp pairing and returns the Base64 QR code string to scan with the WhatsApp mobile app.

HTTP Endpoint

POSThttps://api-wa.hidessh.com/api/v1/wa/devices/{deviceId}/pair

Authentication

This endpoint requires Bearer authentication via your secret API Key.
Header KeyValueRequired
AuthorizationBearer <your_api_key>Required
Content-Typeapplication/jsonRequired

Request Parameters

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

ParameterTypeRequiredDescription
deviceId
stringRequired

Unique ULID identifier of the device slot.

example: 01M1WW3FKR1JS7CW4KGY78Q5ND

Code Examples

request.sh
curl -X POST "https://api-wa.hidessh.com/api/v1/wa/devices/01M1WW3FKR1JS7CW4KGY78Q5ND/pair" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Formats

QR pairing code generated.

application/json • 200 OK
{
  "success": true,
  "message": "QR code generated",
  "payload": {
    "device_id": "01M1WW3FKR1JS7CW4KGY78Q5ND",
    "qr_code": "2@qP...base64_qr_data...",
    "expires_in_seconds": 60
  }
}