Pairing and connection

Connect token

Prepares a token for first-time pairing or reconnects a paired token that is not currently connected.

POST /api/v1/sessions/{sessionId}/connect
Authorization: Bearer <api_key>

Reconnect is the same API call as connect:

POST /api/v1/sessions/{sessionId}/connect
Authorization: Bearer <api_key>

Use reconnect when a token is already paired but not ready to send:

{
  "paired": true,
  "active": false,
  "connected": false,
  "connectionState": "inactive"
}

WADial reconnects the same linked device. You do not need to scan QR or request a pairing code again unless the token was logged out or unpaired.

GET /api/v1/sessions/{sessionId}/auth/qr
Authorization: Bearer <api_key>

Pairing code is only for tokens that are not paired yet. Connect the token first, then request a code.

POST /api/v1/sessions/{sessionId}/auth/pairing-code
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "phoneNumber": "15551234567"
}

If the token is already paired, use reconnect instead of requesting another pairing code.

Disconnects the token while keeping it paired.

POST /api/v1/sessions/{sessionId}/disconnect
Authorization: Bearer <api_key>

Logs out the linked device. Use this when the token should be unpaired.

POST /api/v1/sessions/{sessionId}/logout
Authorization: Bearer <api_key>

GET /api/v1/sessions/{sessionId}/events
Authorization: Bearer <api_key>
Accept: text/event-stream