Connect a number in the Console
Add a Number from the Console by pairing a phone, sending a QuickLink or creating a test number.
The New number dialog in the Console connects a Number to the open project. Pair a phone that is with you, send a link to whoever has the phone, add a test number, or start an import. Every real-number path uses QuickLink underneath.
Before you begin#
- An active team and project. Funding is checked when pairing starts; creating a link does not reserve paid service.
- For real numbers on a Free team, enough of the team's real-number allowance. See Free team limits.
- Meta Cloud API and test numbers each require access.
Add a number #
Open a project, go to Numbers and select New number. Choose one path:
| Path | Time | What it does |
|---|---|---|
| Create a testing number for free | About 10 seconds | Adds a simulated test number for development and automated tests. It cannot contact real WhatsApp recipients. |
| Link a real number now | About 2 minutes | Pairs a phone inside the Console with a QR code or pairing code. |
| Send a QuickLink | About 2 minutes | Creates a link for the person who has the phone. They need no account. |
| Import existing sessions | About 10 minutes | Shows the steps to move Baileys or whatsmeow authentication state. See Import existing sessions. |
On a Free team, a real-number path shows Requires Pay-As-You-Go once the team has used its real-number allowance, and Send a QuickLink for a real number always shows it. The prompt below the choices opens Upgrade to Pay-As-You-Go.
Hybrid Link and the Meta Cloud API connection choices each appear only when the team can use them. Otherwise the Console shows the reason: Not set up for this team, Not enabled for this team or Turned off by Polymorfa. When Meta Cloud API is unavailable, a shared QuickLink offers Linked Devices only. If the Console cannot verify availability, both stay unavailable until you reopen the dialog.
Pair a phone that is with you#
Choose Link a real number now
The dialog starts an authenticated pairing flow. It cannot be shared or opened outside the Console.
Pair the phone
Scan the QR code from Linked devices in WhatsApp, or select phone-number pairing and enter the code on the phone.
Confirm the connection
Confirm on the page. The Number appears in the list as Connected.
Closing the dialog while pairing cancels that pending connection.
Send a QuickLink#
Choose Send a QuickLink
The dialog opens the settings for this link only: connection type, pairing methods, phone handling and history sync. Your project defaults stay unchanged.
Generate and share the link
Copy it, share it or show it as a QR code.
Follow its progress
The dialog shows when the link is opened, linked and connected. The Number appears in the list when the recipient confirms.
Closing the dialog does not cancel a link you sent. It stays usable until it connects a Number or you cancel it. Generate a new link creates a separate link. See Connect a number with QuickLink for every setting and status.
Create a test number#
Choose Create a testing number for free, or select Add test number under Test numbers to open the same form directly. Pick a country and select Create setup link. Search the country picker by name, short name or calling code; the default is the United States. Test numbers appear under Test numbers and do not start a real WhatsApp connection.
From the API, create a test number with a QuickLink that includes configuration.testing. See Test numbers.
Verify the Number#
The new Number appears in Numbers with Connected in the Connection column. Select it to open its page, then send a test message. See Start, stop and restart Numbers for status, controls and configuration.