> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wadial.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pair with a QR code

> Connect a token and pair it from WhatsApp linked devices.

Use QR pairing when you can open WhatsApp on the phone you want to link. After pairing, the token can reconnect without another QR scan unless you log it out.

## Prepare the token

1. Open the WADial dashboard
2. Open the token
3. Click **Scan device**
4. Wait for the QR code to appear

You can also prepare the token with the API:

```http theme={null}
POST /api/v1/sessions/{sessionId}/connect
Authorization: Bearer <api_key>
```

## Scan from WhatsApp

1. Open WhatsApp on the phone
2. Open **Linked devices**
3. Tap **Link a device**
4. Scan the QR code shown in WADial

The token status changes to `paired: true` and `connected: true` after WhatsApp accepts the link.

## Refresh an expired QR

QR codes expire after a short time. If the dashboard shows an expired QR, click **Scan device** again or call `connect` again.