How do I create new users in the Bandwidth Dashboard?

Follow

Suzanna Reid

Updated

Note: Only account admins can create new users in the Bandwidth Dashboard. Admins also have the ability to create API credentials that allow their software developers to authenticate their applications to Bandwidth's APIs.

How do I create a new user?

  1. Log into the Bandwidth Dashboard.
  2. In the top navigation menu, select Account and click Users.
  3. Click Add and scroll down to the User Information section.
  4. Under Administration level, select whether the user should be a Basic User or an Account Admin. 

administration-level.png

  1. Under User access method, choose how the user should be able to use their credentials:

    • Select Allow user to login to the Bandwidth Dashboard to allow the user to use their credentials to log into the Bandwidth Dashboard. Please note that they will be required to reset their password every 90 days.

      bandwidth-dashboard-access.png

    • Select Allow user credentials to authenticate API to allow the user to use their credentials to authenticate API calls. Since an API user is expected to perform automated processes, they won't be required to reset their password but also won't be able to use these credentials to log into the Bandwidth Dashboard. To address this, many developers choose to have one set of credentials to access the Bandwidth Dashboard and another to validate API calls.

api-access-method.png

  1. Enter the user's information. If you selected Allow user credentials to authenticate API, the username, first name, and last name will be generated automatically but you can still edit them.

Note: The username can't be changed once the user is created, so please make sure to double-check it before saving. In addition, you must enter the phone number in a 10-digit format. Each user will need to verify it using the same exact format. 

new-user-form.png

  1. Scroll down to the Password section to set up the password for the user. Please make sure to let them afterward so that they can use it to log in. You can also skip this step to let the user create their own password later.
  2. Scroll down to the Roles section to select which account roles the user should have access to. For more information, see User role definitions.
  3. Scroll down to the Accounts section to select which account(s) the user should have access to. If your organization has multiple Bandwidth Dashboard accounts, you can grant the user access to those here.
  4. Click Save Changes.

Once you create the user, they'll receive an email with their username. It'll also ask them to verify their account information. Once they verify it, they'll receive a second email with their password. If you didn't create a password for the user, they'll be able to do so themselves.

How do I deactivate a user?

Users can be deactivated, but they can't be deleted. To deactivate a user:

  1. Log into the Bandwidth Dashboard.
  2. In the top navigation menu, select Account and click Users.
  3. Select the user you want to deactivate.
  4. Set the toggle switch to Deactivated

User switch set to deactivated

User role definitions

Billing Reports Allows user to create and view billing reports.
Campaign Management Allows user to manage campaign provisioning.
Configuration Allows user to configure Sub-accounts and Locations.
Disconnect Allows user to disconnect phone numbers.
E911 Management Allows user to manage E911 settings (applicable for UC accounts).
External TNs Allows user to access external TNs API and UI (applicable for Hosted Messaging).
HTTP Application Management Allows user to manage HTTP applications in the UI (applicable for Messaging API accounts).
HTTP Voice Allows user to make HTTP Voice API calls.
Line Features Allows user to manage phone number line features, such as CNAM and DL/DA.
Messaging Insights Allows user to view messaging insights.
Numbers Insights Allows user to view numbers insights.
Ordering Allows user to search and order new phone numbers from Bandwidth's inventory.
Porting Allows user to port phone numbers in and out of their Bandwidth account.
Reporting Allows user to access available reports for their account and create or manage notifications. As long as the product for which the notification is being created is active on the account, an API user can set it up using this process.
SIP Credentials Allows user to view and manage SIP credentials. 
TN Lookup Allows user to access the TN Lookup API. This also requires TN Lookup to be enabled at the account level.
Voice Insights
Allows user to view voice insights.

Note: By default, API users with no assigned role(s) will have the ability to perform GET requests against the following endpoints:

  • Orders:
    • https://dashboard.bandwidth.com/api/accounts/{accountId}/orders
  • Order Details:
    • https://dashboard.bandwidth.com/api/accounts/{accountId}/orders/{orderId}
  • SIP Peer Details:
    • https://dashboard.bandwidth.com/api/accounts/{accountId}/sites/{siteId}/sippeers
  • Admin Edge Settings:
    • https://dashboard.bandwidth.com/api/accounts/{accountId}/products/edgemanagement/settings
  • Subscriptions API:
    • https://dashboard.bandwidth.com/api/accounts/{accountId}/subscriptions

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

Article is closed for comments.