This article explains how to move phone numbers in the Bandwidth App. For instructions on how to move your phone numbers via API, visit our dev docs.
Prerequisites for moving phone numbers
Before any move can take place, please ensure the following prerequisites are met:
You have the Configuration or Line Features role enabled.
You have access to the accounts you plan to move numbers across.
The accounts belong to the same Global Account Number (GAN). To confirm this:
Log in to the Bandwidth App
In the upper-left corner, select the account from the drop-down menu.
In the side navigation bar, click Account and select Overview.
The numbers belong to the North American Numbering Plan (NANP).
Note: The ability to move international numbers is coming soon!
Moving phone numbers
You can move up to 5000 phone numbers between your accounts and associated sub-accounts and/or locations. To begin, complete the following steps:
Log in to the Bandwidth App.
In the side navigation bar, select Numbers and click My Numbers.
Complete the steps under one of the following sections, based on how you want to choose the numbers to upload:
Option 1: Enter, paste, or upload a list of numbers
In the lower-right corner of the My Inventory tab, click Actions.
Under Quick bulk actions, select Move all numbers.
In the Phone numbers field, enter, paste, or upload the numbers you want to move.
Select the Destination account, Sub-account and Location where you want to move your numbers.
If applicable, complete the following:
If the numbers have an existing E911 configuration, select whether you want to Migrate or Delete it.
If the destination account is enabled on the Universal Platform, select:
Voice Configuration Package (VCP): This allows the number to have voice service configured when it’s moved.
(Coming soon) Requirements Package (RP): This is for international numbers that need end-user information to be activated.
Review the validation check results and click Continue.
Once you’re ready to move your numbers, click Move Numbers.
Important: Moving numbers to another account may cause service disruption. Ensure you understand the potential disruptions before moving numbers.
Click View Order in the order confirmation message at the top of the page to view your Move Phone Numbers Order details page for this order. If numbers have been moved from another account, it will be listed under Source account.
Note: You can return to this page anytime by searching for your order.
Option 2: Select numbers from your inventory
In the My Inventory tab, search and select the specific numbers you want to move.
In the lower-right corner, click Actions.
Under To selected number(s), click Move selected numbers.
Select the Destination account, Sub-account and Location where you want to move your numbers.
If applicable, complete the following:
If the numbers have an existing E911 configuration, select whether you want to Migrate or Delete it.
If the destination account is enabled on the Universal Platform, select:
Voice Configuration Package (VCP): This allows the number to have voice service configured when it’s moved.
(Coming soon) Requirements Package (RP): This is for international numbers that need end-user information to be activated.
Review the validation check results and click Continue.
Once you’re ready to move your numbers, click Move Numbers.
Important: Moving numbers to another account may cause service disruption. Ensure you understand the potential disruptions before moving numbers.
Click View Order in the order confirmation message at the top of the page to view your Move Phone Numbers Order details page for this order. If numbers have been moved from another account, it will be listed under Source account.
Note: You can return to this page anytime by searching for your order.
