Account Credentials

This guide will cover the different credentials for interacting with Bandwidth's APIs, and how to authenticate on each API.

Basic Authorization

All of Bandwidth's APIs are protected with Basic Authorization over HTTPS. Basic Authorization requires the credential pair to be encoded with base64 as part of the Authorization HTTP header.

API Credentials (Voice, Numbers, Account Management)

All three of Voice, Numbers, & Account Management APIs leverage your API Credentials created specifically for API access. The API Credential pair for Voice, Numbers, & Account Management must be created as a unique set within Dashboard. Learn more about creating your API Credentials in the support article.

⚠️ The API Credential pair are separate from your Login Username & Password and can not be used to access the dashboard. Further, your login username and password can not be used to access the Voice, Numbers, & Account Management APIs.

Token & Secret (Messaging Only)

Bandwidth's Messaging API leverages server-side generated API Token & API Secrets. Learn more about creating and managing Tokens and Secrets in the support article.

Credentials Snapshot

Credential Name Description Example
username The username of your API Credentials for the Bandwidth Dashboard jdoe
password The password of your API Credentials for the Bandwidth Dashboard correct-horse-battery-staple
accountId Your unique account id. The accountId is used as part of the url to make API requests.
Ex: https://dashboard.bandwidth.com/api/accounts/{accountId}/
920012
subAccountId
-or-
siteId
Any id for any sub-account. The subAccountId is used as part of the url to make some API requests.
Ex: https://dashboard.bandwidth.com/api/accounts/{accountId}/sites/{sideId}

ℹ️ Sub-accounts are also known as sites
ℹ️ An account can have multiple sub-accounts
13606
apiToken Messaging Only Your unique api token. The apiToken is used as the username to authenticate to the API as part of the basic auth scheme f12a9edeed04ecd21b303c6f1f9f0831a1482f7f3c59199e
apiSecret Messaging Only Your unique api secret. The apiSecret is used as the password to authenticate to the API as part of the basic auth scheme j54935lddasl837592356aasdf8359hlo3
applicationId The ID of your messaging application 532qd-fk5odk5-dlslka40-l5k3lsdmc

Voice Credentials Needed

Credential Name How it is used
accountId Used as a URL parameter for the API endpoint https://voice.bandwidth.com/api/v2/accounts/{accountId}
username Used as the username for HTTP basic auth
password Used as the password for HTTP basic auth

Messaging Credentials Needed

Credential Name How it is used
accountId Used as a URL parameter for the API endpoint https://messaging.bandwidth.com/api/v2/users/{accountId}/messages
apiToken Used as the username for HTTP basic auth
apiSecret Used as the password for HTTP basic auth
applicationId Used as a parameter in the request body

Numbers & Account Management Credentials Needed

Credential Name How it is used
accountId Used as a URL parameter for the API endpoint https://dashboard.bandwidth.com/api/accounts/{accountId}
username Used as the username for HTTP basic auth
password Used as the password for HTTP basic auth


results matching ""

    No results matching ""