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 username, first name, last name, email, and work phone (optional). Make sure to enter the work phone using the 10-digit format – each user will need to verify it using the same format.

Note: If the username and/or email you've entered already exist in the Bandwidth Dashboard, you'll see an error. To resolve it, please use a different username and/or email. If you've selected Allow user credentials to authenticate API, the username, first name, and last name will be generated automatically, although you'll still be able to edit them.

Important: The username can't be changed once the user has been created, so please make sure to double-check it before saving.

new-user-information.png

  1. Click Roles to select which account roles the user should have access to. For more information, see User role definitions.
  2. Click Accounts 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.
  3. Click Save Changes.
  4. Once you create the user, they’ll receive an email containing their username and asking them to verify their account information. Once they verify it, they’ll receive a second email prompting them to create a password. Please note that the password must not contain the username, first name, last name, or email address.

Important: The user must verify their account information to be able to use the Bandwidth Dashboard. Until they do so, their email will be marked Unverified. If they're unable to locate the original verification email, you can resend it to them by clicking Send a Verification Email.

unverified-email.png

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

active-deactivated-button.png

User role definitions

Billing Reports Allows the user to create and view billing reports.
Campaign Management Allows the user to manage campaign provisioning.
Configuration Allows the user to configure Sub-accounts and Locations.
Disconnect Allows the user to disconnect phone numbers.
E911 Management Allows the user to manage E911 settings (applicable for UC accounts).
External TNs Allows the user to access external TNs API and UI (applicable for Hosted Messaging).
HTTP Application Management Allows the user to manage HTTP applications in the UI (applicable for Messaging API accounts).
HTTP Voice Allows the user to make HTTP Voice API calls.
Line Features Allows the user to manage phone number line features, such as CNAM and DL/DA.
Messaging Insights Allows the user to view messaging insights.
Numbers Insights Allows the user to view numbers insights.
Ordering Allows the user to search and order new phone numbers from Bandwidth's inventory.
Porting Allows the user to port phone numbers in and out of their Bandwidth account.
Reporting Allows the 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 the user to view and manage SIP credentials. 
TN Lookup Allows the user to access the TN Lookup API. This also requires TN Lookup to be enabled at the account level.
Voice Insights
Allows the 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.