Legacy Device API
Migrate to API v1
Map Device/QR calls to the unified v1 surface. Webhooks must move to v1 for live event delivery.
| Legacy Device | API v1 |
|---|---|
GET /device-api/v1/instances |
GET /v1/devices (v1 uses the numeric channel id, not instance_id: match phone_number to find it) |
POST /device-api/v1/instances |
POST /v1/devices |
GET /device-api/v1/instances/{instance_id}/qr |
POST /v1/devices/{id}/qr (numeric id from GET /v1/devices) |
GET /device-api/v1/instances/{instance_id}/status |
GET /v1/devices/{id}/status (numeric id from GET /v1/devices) |
POST /device-api/v1/messages/text |
POST /v1/messages with whatsapp_account_id = numeric id from GET /v1/devices |
Legacy device webhooks |
POST /v1/webhooks (unified Cloud + Device events) |