Skip to main content
POST
Set Default Caller
Requires a Labs OAuth user access token with the super_user role and Admin or Owner workspace access. API keys are not accepted for this endpoint. See authentication. Outbound calls placed through this configuration that don’t specify a from_number use the default caller. Setting a new default automatically clears the previous one — at most one phone number per configuration can be the default caller.

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.

Path Parameters

config_id
integer
required
phone_number_id
integer
required

Response

Successful Response

address
string
required
address_normalized
string
required
address_type
string
required
created_at
string<date-time>
required
extra_metadata
Extra Metadata · object
required
id
integer
required
is_active
boolean
required
is_default_caller_id
boolean
required
telephony_configuration_id
integer
required
updated_at
string<date-time>
required
country_code
string | null
inbound_workflow_id
integer | null
inbound_workflow_name
string | null
label
string | null
provider_sync
ProviderSyncStatus · object | null