Tokens - WADial

A token is a stable sessionId. WADial returns it when you create a token; store it in your system and use it as the path parameter for pairing, status, connection, messaging, and call endpoints.

Create token

POST /api/v1/sessions
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "displayName": "Support line",
  "deviceBrowser": "Chrome"
}

Do not provide your own sessionId. WADial creates the token ID and keeps using that same value for future operations.

List all tokens

GET /api/v1/sessions
Authorization: Bearer <api_key>

List connected tokens

Call GET /api/v1/sessions and keep records where connected is true. status: "connected" alone means the token has connected before. Always check connected: true before sending. If a paired token has connected: false, reconnect it before sending.

Get token status

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

The status response includes connection state, pairing state, linked phone JID, QR availability, and timestamps. Important fields:

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

paired: WhatsApp is linked to this token.
active: WADial is preparing or maintaining a live connection for this token.
connected: the token is ready for message sends and calls.
connectionState: current connection state, such as connecting, connected, inactive, disconnected, or error.

Delete token

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