Skip to content
Shortcut: /, ⌘K or Ctrl+K

Connect a number in the Console

Add a Number from the Console by pairing a phone, sending a QuickLink or creating a test number.

View as Markdown

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:

PathTimeWhat it does
Create a testing number for freeAbout 10 secondsAdds a simulated test number for development and automated tests. It cannot contact real WhatsApp recipients.
Link a real number nowAbout 2 minutesPairs a phone inside the Console with a QR code or pairing code.
Send a QuickLinkAbout 2 minutesCreates a link for the person who has the phone. They need no account.
Import existing sessionsAbout 10 minutesShows 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#

  1. The dialog starts an authenticated pairing flow. It cannot be shared or opened outside the Console.

  2. Pair the phone

    Scan the QR code from Linked devices in WhatsApp, or select phone-number pairing and enter the code on the phone.

  3. Confirm the connection

    Confirm on the page. The Number appears in the list as Connected.

Closing the dialog while pairing cancels that pending connection.

  1. The dialog opens the settings for this link only: connection type, pairing methods, phone handling and history sync. Your project defaults stay unchanged.

  2. Copy it, share it or show it as a QR code.

  3. 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.

See also#