Set Default Caller

Designate a phone number as the configuration's default outbound caller id

1 min read

post/api/v1/organizations/telephony-configs/{config_id}/phone-numbers/{phone_number_id}/set-default-caller

Request example

curl --request POST \
  --url https://voice.menaceui.com/api/v1/organizations/telephony-configs/{config_id}/phone-numbers/{phone_number_id}/set-default-caller \
  --header 'authorization: <string>' \
  --header 'X-API-Key: <string>'

Response

{
  "id": 1,
  "telephony_configuration_id": 1,
  "address": "<string>",
  "address_normalized": "<string>",
  "address_type": "<string>",
  "country_code": "<string>",
  "label": "<string>",
  "inbound_workflow_id": 1,
  "inbound_workflow_name": "<string>",
  "telephony_trunk_id": 1,
  "is_active": true,
  "is_default_caller_id": true,
  "extra_metadata": {},
  "created_at": "2026-08-10T12:00:00Z",
  "updated_at": "2026-08-10T12:00:00Z",
  "provider_sync": {
    "ok": true,
    "message": "<string>"
  }
}

post/api/v1/organizations/telephony-configs/{config_id}/phone-numbers/{phone_number_id}/set-default-caller

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.

Path parameters

config_idintegerrequired#

phone_number_idintegerrequired#

Headers

authorizationstring · null#

X-API-Keystring · null#

Responses

application/json

Successful Response

idintegerrequired#

telephony_configuration_idintegerrequired#

addressstringrequired#

address_normalizedstringrequired#

address_typestringrequired#

country_codestring · null#

Show child attributes

Any of

labelstring · null#

Show child attributes

Any of

inbound_workflow_idinteger · null#

Show child attributes

Any of

inbound_workflow_namestring · null#

Show child attributes

Any of

telephony_trunk_idinteger · null#

Show child attributes

Any of

is_activebooleanrequired#

is_default_caller_idbooleanrequired#

extra_metadataobjectrequired#

created_atstringrequired#

updated_atstringrequired#

provider_syncobject · null#

Show child attributes

Any of

okbooleanrequired#

messagestring · null#

Show child attributes

Any of

Delete Phone Number Validate Workflow