telephony.configs.create

Connect a carrier account.

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.

Reference

POST/api/v1/organizations/telephony-configs

Auth: API key in X-API-Key
Content: application/json
Returns: 200 · TelephonyConfigurationDetail

Create a new telephony configuration for the org.

Arguments

Argument	In	Type	Required
`name`	body	`string`	required
`is_default_outbound`	body	`boolean`	default false
`config`	body	`ARIConfigurationRequest \| CloudonixConfigurationRequest \| PlivoConfigurationRequest \| TelnyxConfigurationRequest \| TwilioConfigurationRequest \| VobizConfigurationRequest \| VonageConfigurationRequest`	required

Example request

curl -X POST "https://api.decibyl.ai/api/v1/organizations/telephony-configs" \
  -H "X-API-Key: dcb_your_key" \
  -H "Content-Type: application/json" \
  -d '{"name":"string","is_default_outbound":false,"config":{"provider":"ari","ari_endpoint":"string","app_name":"string","app_password":"string","ws_client_name":"","from_numbers":["string"]}}'

Response

{
  "id": 1,
  "name": "string",
  "provider": "string",
  "is_default_outbound": true,
  "credentials": {},
  "created_at": "2026-09-14T09:30:00Z",
  "updated_at": "2026-09-14T09:30:00Z"
}

Errors

Status	When
`404`	Not found
`422`	Validation Error