Talkr AI
API ReferenceTelephony ConfigurationsPhone Numbers

Add Phone Number

Attach a new phone number to a telephony configuration

Set inbound_workflow_id to bind incoming calls on this number to a specific agent — Talkr 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 Talkr organizations, since inbound dispatch keys on it. Attempting to add a number that another organization already owns returns 409.

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

Path Parameters

config_id*Config Id

Header Parameters

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

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.

Response Body

application/json

application/json

curl -X POST "https://example.com/api/v1/organizations/telephony-configs/0/phone-numbers" \  -H "Content-Type: application/json" \  -d '{    "address": "string"  }'
{  "id": 0,  "telephony_configuration_id": 0,  "address": "string",  "address_normalized": "string",  "address_type": "string",  "country_code": "string",  "label": "string",  "inbound_workflow_id": 0,  "inbound_workflow_name": "string",  "is_active": true,  "is_default_caller_id": true,  "extra_metadata": {},  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z",  "provider_sync": {    "ok": true,    "message": "string"  }}