Skip to main content
POST
Reconnect Instance
Auth: TokenAccount or TokenInstanceRate-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
After the call, poll 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.
If WhatsApp logged out the device (loggedout state), reconnect fails with 400. Use connect to generate a new QR.

Next

Connect (QR/pairing)

To reconnect when the session has been lost.

Logout

Logs the device out of WhatsApp while keeping the instance.