# 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](https://docs.polymorfa.com/numbers/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](https://docs.polymorfa.com/numbers/quicklink#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](https://docs.polymorfa.com/numbers/import-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](https://docs.polymorfa.com/billing/upgrade).

**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](https://docs.polymorfa.com/numbers/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](https://docs.polymorfa.com/testing/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](https://docs.polymorfa.com/numbers/manage) for status, controls
and configuration.

## See also

- [Connect a number with QuickLink](https://docs.polymorfa.com/numbers/quicklink)
- [Start, stop and restart Numbers](https://docs.polymorfa.com/numbers/manage)
- [Test numbers](https://docs.polymorfa.com/testing/test-numbers)
- [Use the Console](https://docs.polymorfa.com/get-started/console)
