How to Create Sub-Accounts & Locations in the Bandwidth Dashboard


Chase Greiser


This article references the ‘New’ interface in the Bandwidth Dashboard. Looking for the ‘Classic’ experience? Click here!

Table of Contents



Origination Settings

Termination Settings

SMS Settings

MMS Settings


Once you've logged into the Bandwidth Dashboard, the first thing you want to do is set up your initial Sub-Accounts and Locations*. This article provides instructions on how to do it.

 *Please note that both the Sub-Accounts (Sites) and Locations (Sip Peers) aren’t intended to grow in an unbounded manner. We don’t recommend moving beyond 50 Sub-Accounts, or 250 total Locations. Exceeding these thresholds may affect system responsiveness. 



Sub-Accounts, also known as Sites, contain a name that appears in a list on the homepage on the Bandwidth Dashboard. You can think of them as the filing cabinet of the Bandwidth Dashboard, where you’re free to organize your Sub-Accounts based on end-user, location or other preferred method. 


Locations house your routing IP's for Origination, Flat Rate Termination and Messaging. You can think of them as file folders where your telephone numbers reside.  Although each Sub-Account can have as many locations as needed, only 10 origination IP addresses/DNS hosts may be provisioned for a single Location. In addition, locations also allow provisioning for SMS hosts, if you’re subscribed to this feature.


Perform the following steps to begin your account setup:

  1. From the top navigation menu, click 'Account' -> ‘Sub-accounts’ -> 'Add Sub-account'.
  1. Fill in the required information, such as name, address, address type, and then click ‘Submit’.



  1. To create your Location, go to the top navigation menu and click 'Account' -> 'Locations' -> 'Add Location'.

  2. You’ll need to complete the following fields in the Create location provisioning box:

  • Sub-Account: Select a sub-account that you want to associate with this Location.
  • Location Name: Type the name of the 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: Mark this checkbox 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.
  • Voice Protocol: If you’re contracted for V2 Voice, you’ll see this option available. Otherwise it won't display and will default to ‘SIP Voice’.



Origination settings

  • CNAM Options: If you subscribe to the inbound CNAM per number feature, here are your options:
    • Flip the switch to ‘CNAM Display (Caller ID)' to turn it on as a default setting for all phone numbers on the Location.
      • Leave this off to make 'CNAM Display (Caller ID)' default to Off.
    • Flip the 'Enforced for all numbers' toggle on to globally apply this setting.
      • If you choose to keep it off, you’ll be able to update the ‘CNAM Display (Caller ID)’ settings on each phone number.
  • Origination Hosts: For the Origination host, enter the IP address(es) or DNS host(s) in the box provided. The system can accept up to 10 IPs per Location. To add additional IPs for routing, set your traffic distribution mechanism to either ‘Random’ or ‘Sequential failover’ and click ‘+add an IP address’ or ‘bulk edit’. Here’s what each option means:
    • None: Only one IP can be entered for this selection and all calls will route to this IP.
    • Random: Traffic will be sent to IPs in a random order.
    • Sequential Failover: Traffic will failover on the IPs in the order in which they’re entered (should the first (top) priority IP fail to respond).




Termination settings

  • Termination hosts
    • If you subscribe to our Unified Communications (UC) product, enter your IPs for routing outbound calls in this section.
    • Otherwise, your whitelist is housed in a separate database at Bandwidth. Click the link provided to open a ticket with us and we’ll be happy to whitelist additional IPs for Termination.

 SMS and MMS Settings

When you are finished, click ‘Save Changes’.

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

Article is closed for comments.