Skip to main content
POST
/
api
/
v1
/
organizations
/
telephony-configs
/
{config_id}
/
phone-numbers
Create Phone Number
curl --request POST \
  --url https://app.dograh.com/api/v1/organizations/telephony-configs/{config_id}/phone-numbers \
  --header 'Content-Type: application/json' \
  --data '
{
  "address": "<string>",
  "country_code": "<string>",
  "label": "<string>",
  "inbound_workflow_id": 123,
  "is_active": true,
  "is_default_caller_id": false,
  "extra_metadata": {}
}
'
{
  "id": 123,
  "telephony_configuration_id": 123,
  "address": "<string>",
  "address_normalized": "<string>",
  "address_type": "<string>",
  "is_active": true,
  "is_default_caller_id": true,
  "extra_metadata": {},
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "country_code": "<string>",
  "label": "<string>",
  "inbound_workflow_id": 123,
  "inbound_workflow_name": "<string>",
  "provider_sync": {
    "ok": true,
    "message": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.dograh.com/llms.txt

Use this file to discover all available pages before exploring further.

Set inbound_workflow_id to bind incoming calls on this number to a specific agent — Dograh will register the inbound webhook with the provider and the response will include a provider_sync block reporting the result. Omit it to add the number for outbound use only. The (provider, account_id, address) tuple must be globally unique across all Dograh organizations, since inbound dispatch keys on it. Attempting to add a number that another organization already owns returns 409.

Headers

​
authorization
string | null
​
X-API-Key
string | null

Path Parameters

​
config_id
integer
required

Body

application/json

Create a new phone number under a telephony configuration.

address_normalized and address_type are computed server-side from address (and country_code if PSTN). address itself is stored verbatim for display.

​
address
string
required
Required string length: 1 - 255
​
country_code
string | null
Required string length: 2
​
label
string | null
Maximum string length: 64
​
inbound_workflow_id
integer | null
​
is_active
boolean
default:true
​
is_default_caller_id
boolean
default:false
​
extra_metadata
Extra Metadata · object

Response

Successful Response

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

Result of pushing a phone-number change to the upstream provider.

Returned alongside create/update responses when the route attempted to sync inbound webhook configuration. ok=False is a warning, not a fatal error — the DB write succeeded.