Talkr AI
API ReferenceTelephony Configurations

Create Configuration

Create a new telephony configuration

Call List Supported Providers first to discover the credential fields for the provider you want to configure — they vary per provider.

Configuration name must be unique within your organization. Set is_default_outbound: true to mark this configuration as the org-wide default for outbound calls (any existing default is unset). New configurations have no phone numbers; add them via Add a phone number.

POST
/api/v1/organizations/telephony-configs

Header Parameters

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Body for POST /telephony-configs.

config carries the provider-specific credential fields (the same discriminated union used by the legacy single-config endpoint). Any from_numbers on the inner config are ignored — phone numbers are managed via the dedicated phone-numbers endpoints.

Response Body

application/json

application/json

curl -X POST "https://example.com/api/v1/organizations/telephony-configs" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "config": {      "ari_endpoint": "string",      "app_name": "string",      "app_password": "string"    }  }'
{  "id": 0,  "name": "string",  "provider": "string",  "is_default_outbound": true,  "credentials": {},  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z"}