Reconnect using stored credentials
Reloads the stored WUTS session and reconnects the WhatsApp device WITHOUT a QR scan. This is the primitive the self-heal loop calls to recover instances after a gateway or host restart; if credentials are gone it signals that re-pairing is required.
Reloads the stored WUTS session and reconnects the WhatsApp device WITHOUT a QR scan. This is the primitive the self-heal loop calls to recover instances after a gateway or host restart; if credentials are gone it signals that re-pairing is required.
Authorization
bearerAuth Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.
In: header
Query Parameters
Target WUTS device identifier. When omitted, the device is resolved from the authenticated session.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/connect"{ "success": true, "data": { "status": "connected", "device_id": "wuts-device-001", "needs_qr": false }}{ "success": false, "error": "unauthorized"}{ "success": false, "error": "device not found"}{ "success": false, "error": "reconnect failed"}Confirm passkey pairing code POST
Final step of passkey pairing. After the `pair.passkey_confirmation` webhook delivers the verification code, show it to the user; once they confirm it matches the one on their phone, call this endpoint to finish the handshake. Pairing then completes and the `pair.success` webhook fires. The body is optional — pass `device_id` to target a specific device.
Create a device POST
Registers a new WUTS device (WhatsApp instance) for the authenticated user. The device starts disconnected and must be paired separately to bind a WhatsApp number.