WahideAPI Docs
POST

Create Device Slot

Allocates a new WhatsApp device slot ready for QR code pairing.

HTTP Endpoint

POSThttps://api-wa.hidessh.com/api/v1/wa/devices

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
push_name
stringRequired

Friendly label for this device (e.g. 'CS Sales Bandung').

example: CS Sales Bandung

Code Examples

request.sh
curl -X POST "https://api-wa.hidessh.com/api/v1/wa/devices" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "push_name": "CS Sales Bandung"
  }'

Response Formats

Device slot created with QR_PENDING status.

application/json • 201 Created
{
  "success": true,
  "message": "device created successfully",
  "payload": {
    "id": "01M1WW3FKR1JS7CW4KGY78Q5ND",
    "push_name": "CS Sales Bandung",
    "status": "QR_PENDING",
    "trust_score": 10,
    "warmup_day": 1
  }
}