Skip to main content
Use a pairing code when scanning a QR code is not convenient. The token must be connected first, and pairing codes only work for tokens that are not already paired.

Prepare the token

Start the token connection:
POST /api/v1/sessions/{sessionId}/connect
Authorization: Bearer <api_key>

Request the code

Send the phone number with country code:
POST /api/v1/sessions/{sessionId}/auth/pairing-code
Authorization: Bearer <api_key>
Content-Type: application/json
{
  "phoneNumber": "15551234567"
}
WADial returns a code formatted for entry in WhatsApp.

Enter the code in WhatsApp

  1. Open WhatsApp on the phone
  2. Open Linked devices
  3. Choose the option to link with a phone number
  4. Enter the code returned by WADial
If the token is already paired, reconnect it instead of requesting another code.