How do I create Sub-accounts and Locations in the Bandwidth Dashboard?


Suzanna Reid



Once you log into the Bandwidth Dashboard, the first thing you need to do is set up your initial Sub-account and Location. This article explains how to do it.


Sub-Accounts help organize your phone number inventory to make grouping services a little easier.

Key Takeaways:

  • Think of your account as a filing cabinet, these are the drawers. You’re free to organize based on customer, end-user, geographical location, or another preferred method.
  • Many users choose to just keep a single Sub-Account. Whereas others create two to represent Development and Production environments.

To add a Sub-account, perform the following steps:

  1. In the top navigation bar, click Account, select Sub-accounts, and then click Add Sub-account.
  2. Enter the required information and click Create Sub-account.



A Location is where you provision your signaling IP addresses and other phone number routing settings. When a number is added to a Location, it inherits the settings and properties of that Location.

Key takeaways:

  • Create new Locations to organize your phone number inventory and configure your IP addresses for Voice and Messaging.
  • You must have a Sub-Account and a Location to start ordering phone numbers.

To add a Location, perform the following steps:

  1. In the top navigation bar, click Account, select Locations, and then click Add Location.
  2. Complete the following fields:
    • Sub-Account: Select a Sub-account that you want to associate with this Location.
    • Location name: Type the name of this Location. This field is required but can contain anything that makes sense to the Location provisioning.
    • Description: An optional field where you can add a description of this Location.
    • Default location: Turn this switch on if you'd like this to be the primary Location. This means that when you order and port, this Location will show up first after you select your Sub-account.


Origination settings

CNAM options

If you subscribe to the inbound CNAM per number feature, you can:

  1. Switch the CNAM display (Caller ID) toggle on to make this a default setting for all phone numbers on the Location. 
  2. Switch the Enforced for all numbers toggle on to apply your CNAM display setting globally. If you choose to keep it off, you’ll be able to update the CNAM display settings on each phone number.

Origination hosts

  1.  Select a traffic distribution mechanism. Here’s what each option means:
    • None: Supports only one IP address.
    • Random: Supports up to 10 IPs. The system will signal to the IPs in a random order, similar to round-robin.
    • Sequential Failover: Supports up to 10 IPs. Traffic will failover on the IPs in the order in which they're entered
  2. Enter the endpoint IP address or DNS host in the Voice IP addresses / DNS hosts field. Click +Add IP Address to add a new line.


Termination settings

If you subscribe to our Unified Communications (UC) product, enter your IPs for routing outbound calls in the Termination hosts field. Otherwise, your whitelist is housed in a separate database at Bandwidth. Please open a ticket with your Bandwidth Support Team and we’ll be happy to whitelist additional IPs for Termination.


SMS and MMS settings

Please see our steps for enabling SMPP SMS and MM4 Messaging and HTTP SMS and MMS Messaging APIs.

Next steps

Now that you’ve set up your Sub-account and added your first Location, we recommend that you order a phone number to ensure that routing is working as intended.

Questions? Please open a ticket with your Bandwidth Support Team or hit us up at (855) 864-7776!

Article is closed for comments.