Skip to main content
POST
Create Configuration
Call List Supported Providers first to discover the credential fields for the provider you want to configure — they vary per provider. Configuration name must be unique within your organization. Set is_default_outbound: true to mark this configuration as the org-wide default for outbound calls (any existing default is unset). New configurations have no phone numbers; add them via Add a phone number.

Authorizations

Authorization
string
header
required

Bandwidth Labs OAuth access token. Uses the user's selected workspace; the workspace header is not required. Do not also send an API key. Bearer-only operations may additionally require the Labs super_user role.

Headers

X-VOAI-ORGANIZATION-ID
string | null

Required with X-BW-LABS-AGENTS-API-KEY: the positive local workspace ID to access. The key owner must be a current member. Missing or invalid IDs return 400; non-member workspaces return 403. Not required for bearer authentication, which uses the user's selected workspace.

Body

application/json
config
BandwidthConfigurationRequest · object
required
name
string
required
Required string length: 1 - 64
is_default_outbound
boolean
default:false

Response

Successful Response

created_at
string<date-time>
required
credentials
Credentials · object
required
id
integer
required
is_default_outbound
boolean
required
name
string
required
provider
string
required
updated_at
string<date-time>
required