Legacy Device API

Instances

Create, pair, reconnect, and monitor Device/QR instances.

GET /instances Public

List Device/QR instances for the account.

curl -H "X-Api-Key: YOUR_API_KEY" \
     -H "X-Api-Secret: YOUR_API_SECRET" \
     https://app.washeej.com/device-api/v1/instances

API v1 equivalent Prefer GET /v1/devices for new integrations. Open API v1 docs →

POST /instances Public

Create a new device instance.

Parameter	Type	Required	Description
`name`	string	required	Display name for the instance.

curl -X POST https://app.washeej.com/device-api/v1/instances \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "X-Api-Secret: YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"name":"My WhatsApp"}'

API v1 equivalent Prefer Create channels in dashboard; list via GET /v1/devices for new integrations. Open API v1 docs →

GET /instances/{instance_id} Public

Get a single instance.

Parameter	Type	Required	Description
`instance_id` path	string	required	Instance unique ID.

curl -H "X-Api-Key: YOUR_API_KEY" \
     -H "X-Api-Secret: YOUR_API_SECRET" \
     https://app.washeej.com/device-api/v1/instances/YOUR_INSTANCE_ID

API v1 equivalent Prefer GET /v1/devices + GET /v1/devices/{id}/status for new integrations. Open API v1 docs →

GET /instances/{instance_id}/qr Public

Get QR code image for pairing.

Parameter	Type	Required	Description
`instance_id` path	string	required	Instance unique ID.

curl -H "X-Api-Key: YOUR_API_KEY" \
     -H "X-Api-Secret: YOUR_API_SECRET" \
     https://app.washeej.com/device-api/v1/instances/YOUR_INSTANCE_ID/qr

API v1 equivalent Prefer POST /v1/devices/{id}/qr for new integrations. Open API v1 docs →

GET /instances/{instance_id}/status Public

Connection status: pending, connected, disconnected.

curl -H "X-Api-Key: YOUR_API_KEY" \
     -H "X-Api-Secret: YOUR_API_SECRET" \
     https://app.washeej.com/device-api/v1/instances/YOUR_INSTANCE_ID/status

API v1 equivalent Prefer GET /v1/devices/{id}/status for new integrations. Open API v1 docs →

POST /instances/{instance_id}/reconnect Public

Request a fresh QR session when disconnected.

curl -X POST https://app.washeej.com/device-api/v1/instances/YOUR_INSTANCE_ID/reconnect \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "X-Api-Secret: YOUR_API_SECRET"

DELETE /instances/{instance_id} Public

Disconnect and delete an instance.

Parameter	Type	Required	Description
`instance_id` path	string	required	Instance unique ID.

curl -X DELETE https://app.washeej.com/device-api/v1/instances/YOUR_INSTANCE_ID \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "X-Api-Secret: YOUR_API_SECRET"

Pairing flow

Create or listPOST /instances or GET /instances

Get QRGET /instances/{id}/qr

ScanWhatsApp → Linked devices → scan

ConfirmPoll status until connected