Instance
Reconnect Instance
Reactivates the whatsmeow client without invalidating the session (no QR re-scan required)
POST
Reconnect Instance
Auth:
After the call, poll
TokenAccount or TokenInstance • Rate-limit: Global (100/min) • Idempotent: partial
Description
Reuses the whatsmeow session already stored to re-establish the connection without a new QR/pairing. Works if the instance has been connected at least once (session saved in whatsmeow_device).Example
Success response
200 OK
GET /api/instance/list?instanceName=<name> to detect when the state becomes connected. The instance.state event is also emitted via webhook/WebSocket.
Path parameters
string
required
Instance name.
Headers
string
required
TokenAccount or TokenInstance.
Body is accepted but ignored, you can send it empty.
Errors
Notes
Difference from
connect: connect always (re)creates a new client and generates QR/pairing. reconnect reuses an existing session, does not work if the instance has never connected or was logged out from the phone side.Next
Connect (QR/pairing)
To reconnect when the session has been lost.
Logout
Logs the device out of WhatsApp while keeping the instance.