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


Chase Greiser


This article references the ‘Classic’ interface in the Bandwidth Dashboard. Looking for the ‘New’ 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-Accountsbased 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 settings

  • Under SMS settings, turn the ‘SMS Enabled’ switch on to display the available options:
    • Toll Free
    • Short Codes
    • Geographic reach
      • Zone 1 will be enabled by default, but you can configure the numbers on this Location for International SMS. Simply toggle the corresponding boxes on to enable international zones and Canadian SMS. 

Note: These options will be disabled if your account isn’t contracted for these messaging features. If you'd like to add these features to your suite of messaging products, feel free to reach out to your Sales representative!



    • SMS Protocol -select ‘SMPP’ from the drop-down menu.
    • SMS IP addresses -Enter the IP address(es) in the box provided. To add additional IPs for routing, click either ‘+add an IP address’ or ‘bulk edit’ The system can accept up to 10 IPs per Location. 
    • Click the gear icon to determine settings for Transceiver, Sender Only, or Receiver Only.
    • Click between your IP addresses to create priority settings for each IP group.

Note: We also offer information on SMPP Gateway setup.




  • Messaging API instructions:
    • SMS Protocol -select ‘HTTP’ from the drop-down menu.
    • Applications - select the appropriate application from the drop-down menu (this step will be available only after you turn ‘V2 Messaging toggle on. Click here to learn how to create an application.


MMS settings

  • Under MMS settings, turn the ‘MMS Enabled’ switch on to display the available options.


  • MM4 MMS
    • MMS Protocol -select ‘MM4’ from the drop-down menu.
    • Transport layer security (TLS)- mark this checkbox to enable TLS. See article about setting up TLS for MM4 for more information on how to set up TLS.
    • MM4 termination hosts - provide your IP addresses for outbound MMS.
    • MM4 origination hosts - provide your IP addresses for inbound MMS. You can enter an IP address or a fully qualified domain name (FQDN). However, if TLS is enabled, only FQDNs are accepted. See article about setting up TLS for MM4 for more information on how to set up TLS.
      • Click between your IP addresses to create priority settings for each IP group.
    • Geographic reach - if you subscribe to Canadian messaging, you can make this determination here.

Note: More information on this can be found on our MM4 Messaging (MMS) Integration Guide


    • MMS Protocol -select ‘HTTP’ from the drop-down menu.
    • Applications-this will automatically select the application specified under the ‘SMS settings’ section.


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.