Skip to main content
Phonely lets you add, import, and manage phone lines connected to your Agents. You can generate a new number instantly, import an existing one from third-party providers, or port your current number into Phonely , all from a single interface.

​
Accessing the Phone Numbers Panel

To add or manage numbers:
  1. Go to Agent Design from the left sidebar.
  2. Click the Call Settings tab at the top.
  3. If this is the first time you adding a number click the Get a Number card alternatively scroll to the bottom of this call settings tab where you’ll find the Additional phone number section.
  4. Click + Add a Number to open the phone number setup window.
You’ll see two tabs at the top of the window:
  • New Number – to generate a Phonely-hosted number.
  • Import Number – to connect an existing number from Twilio, Vonage, or another carrier.

​
Generate a New Number

Use this option to instantly create a new Phonely number that supports both calling and SMS (depending on the country). Purchase Phone Number In Phonely Gi

​
Steps

  1. Select the New Number tab.
  2. Choose your Country Code from the dropdown (e.g., 🇺🇸 United States +1).
  3. Optionally enter an Area Code for local targeting (e.g., 646 for NYC).
  4. Click Generate.
    • Phonely lists available numbers that match your criteria.
  5. Review the list and click Select next to your preferred number.
  6. Click Get Number to confirm.
    Use Regenerate to refresh the list and see more options.

​
Import an Existing Number

If you already use a provider like Twilio or Vonage, you can connect those numbers directly to Phonely. Import Phone Numbers From Twillio Vonage Gi

​
Import from Twilio

  1. Select the Import Number tab.
  2. From the Import your number dropdown, choose From Twilio.
  3. Enter your:
    • Twilio Account SID
    • Twilio Auth Token
  4. Click Import Number.
    Your Twilio number(s) will appear in the dashboard once verified.

​
Import from Vonage

  1. Under Import your number, select From Vonage.
  2. Enter:
    • Phone Number
    • Vonage API Key
    • Vonage API Secret
  3. Click Import Number to connect.

​
3. Port an Existing Number

You can transfer (port) your current phone number to Phonely if you prefer to keep it.

​
Steps for Porting

  1. Select Import Number > Port Number.
  2. Review the porting steps shown:
    • Fill out the form – Verify ownership by answering required questions.
    • Wait for Porting – Phonely will request your number from the existing carrier.
    • Use New Number – Porting completes within 14 days.
  3. Click Process Verification to open the port request form.

​
Port Request Form Requirements

Fill in the Number Port Request form with details such as:
  • Email address
  • Address and billing details
  • Landline or toll-free numbers (if applicable)
  • Upload:
    • Letter of Authorization (LOA)
    • Most recent billing statement
Do not cancel your existing carrier until Phonely confirms port completion.

​
4. Managing Existing Numbers

Once added, your numbers appear in the Additional Phone Numbers table.

​
Set as Primary

  • Click the three-dot menu**(⋮)** next to the number.
  • Select Set as Primary to make this the default outgoing line for your agent.
  • Only one number can be primary at a time.
Calls and messages initiated by your agent will default to the primary number unless overridden in a specific flow.

​
Release a Number

  • From the ⋮ Actions menu, click Release Number.
  • Confirm the prompt to permanently remove the number from your account.