Create Phone Number

POST /api/v1/organizations/telephony-configs/{config_id}/phone-numbers — request parameters and responses from the Menace Voice API schema.

2 min read

post/api/v1/organizations/telephony-configs/{config_id}/phone-numbers

Request example

curl --request POST \
  --url https://voice.menaceui.com/api/v1/organizations/telephony-configs/{config_id}/phone-numbers \
  --header 'authorization: <string>' \
  --header 'X-API-Key: <string>' \
  --header 'Content-Type: application/json' \
  --data '{
  "address": "<string>",
  "country_code": "<string>",
  "label": "<string>",
  "inbound_workflow_id": 1,
  "telephony_trunk_id": 1,
  "is_active": true,
  "is_default_caller_id": false,
  "extra_metadata": {}
}'

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

See authentication for workspace API access. Public embed and artifact endpoints use their documented session or access tokens.

Path parameters

config_idintegerrequired#

Headers

authorizationstring · null#

X-API-Keystring · null#

Body

application/json

addressstringrequired#

Length: 1–255

country_codestring · null#

Show child attributes

Any of

labelstring · null#

Show child attributes

Any of

inbound_workflow_idinteger · null#

Show child attributes

Any of

telephony_trunk_idinteger · null#

Show child attributes

Any of

is_activeboolean#

Default: true

is_default_caller_idboolean#

Default: false

extra_metadataobject#

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

List Phone Numbers Get Phone Number