18 August 2026

Pairing codes — connect a number without scanning a QR

New feature.

New endpoint POST /connections/{id}/pairing-code (scope whatsapp.manage). Body { "phoneNumber": "40740267964" } — E.164 without the leading +, digits only — returns { "code": "7S59-1KZP" }. Your customer types it into WhatsApp → Settings → Linked devices → Link with phone number.

This is the path for the customer who is completing your onboarding on the same phone that runs WhatsApp: there is no second screen to photograph, so the QR simply cannot be used.

A pairing code is not always available — the engine can decline with 502 pairing_code_unavailable, so keep the QR flow on screen as a fallback. Requesting another code on the same connection is allowed (a new code, same session) and capped at 5 per connection per 15 minutes, then 429 rate_limited with Retry-After.

Nothing extra is consumed: the same paid slot and the same 7-day trial as QR pairing, claimed when the number actually pairs. Monitoring is unchanged — poll GET /connections/{id} and/or listen for connection.connected. qr connections only; a cloud_api number answers 409 not_supported_for_provider.

Full guide: Pairing code & QR.