Note: Only account admins can create new users in the Bandwidth App. 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?
Log into the Bandwidth App.
In the side navigation menu, select Account and click Users.
Click Add and scroll down to the User Information section.
Under Administration level, select whether the user should be a Basic User or an Account Admin.
Under User access method, choose how the user should be able to use their credentials.
Important: You will not be able to change this user's access method once you create it. Instead, you will need to create a new user with the desired new access method.
Select Allow user to login to the Bandwidth App to allow the user to use their credentials to log into the Bandwidth App. Please note that they will be required to reset their password every 90 days.
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 App. To address this, many developers choose to have one set of credentials to access the Bandwidth App and another to validate API calls.
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 App, 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.
Click Roles to select which account roles the user should have access to. For more information, see User role definitions.
Click Accounts to select which account(s) the user should have access to. If your organization has multiple Bandwidth App accounts, you can grant the user access to those here.
Click Save Changes.
Once you create the user, they’ll receive an email containing their username and a link to create a password. Please note that the password must not contain the username, first name, last name, or email address.
How do I deactivate a user?
Users can be deactivated, but they can't be deleted. To deactivate a user:
Log into the Bandwidth App.
In the side navigation menu, select Account and click Users.
Select the user you want to deactivate.
Set the toggle switch to Deactivated.
User role definitions
Alerting Insights | Allows the user to create and manage Insights Alerts and displays the Alerting Insights navigation. |
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!