---
title: "Create Telephony Configuration"
method: POST
path: "/api/v1/organizations/telephony-configs"
tags: ["main", "organizations"]
---

# Create Telephony Configuration

`POST /api/v1/organizations/telephony-configs`

Create a new telephony configuration for the org.

## Headers

- `authorization` string, nullable
- `X-API-Key` string, nullable

## Request body

- TelephonyConfigurationCreateRequest — 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.
  - `name` string, required
  - `is_default_outbound` boolean
  - `config` union, required
    - ARIConfigurationRequest — Request schema for Asterisk ARI configuration.
      - `provider` 'ari'
      - `ari_endpoint` string, required — ARI base URL (e.g., http://asterisk.example.com:8088)
      - `app_name` string, required — Stasis application name registered in Asterisk
      - `app_password` string, required — ARI user password
      - `ws_client_name` string — websocket_client.conf connection name for externalMedia (e.g., dograh_staging)
      - `external_pbx` VicidialExternalPBXConfiguration — External-PBX configuration used by the VICIdial strategy adapter.
        - `type` 'vicidial'
        - `agent_api` VicidialAgentAPIConfiguration, required — VICIdial remote-agent call-control API configuration.
          - `url` string, required — Full URL to agc/api.php
          - `username` string, required — VICIdial agent API user
          - `password` string, required — VICIdial agent API password
          - `source` string — VICIdial API source tag
        - `non_agent_api` VicidialNonAgentAPIConfiguration — Optional VICIdial non-agent API configuration for lead updates.
          - `url` string, nullable — Full non_agent_api.php URL
          - `username` string, nullable — Non-agent API user
          - `password` string, nullable — Non-agent API password
          - `source` string — Non-agent API source tag
        - `timeout_seconds` integer
      - `from_numbers` string[] — List of SIP extensions/numbers for outbound calls (optional)
    - CloudonixConfigurationRequest — Request schema for Cloudonix configuration.
      - `provider` 'cloudonix'
      - `bearer_token` string, required — Cloudonix API Bearer Token
      - `domain_id` string, required — Cloudonix Domain ID
      - `application_name` string, nullable — Cloudonix Voice Application name. The application's url is updated when inbound workflows are attached to numbers on this domain. If omitted, an application is auto-created on save and its name is stored on the configuration.
      - `from_numbers` string[] — List of Cloudonix phone numbers (optional)
    - PlivoConfigurationRequest — Request schema for Plivo configuration.
      - `provider` 'plivo'
      - `auth_id` string, required — Plivo Auth ID
      - `auth_token` string, required — Plivo Auth Token
      - `application_id` string, nullable — Plivo Application ID. The application's answer_url is updated when inbound workflows are attached to numbers on this account. If omitted, an application is auto-created on save and its id is stored on the configuration.
      - `from_numbers` string[] — List of Plivo phone numbers
    - TelnyxConfigurationRequest — Request schema for Telnyx configuration.
      - `provider` 'telnyx'
      - `api_key` string, required — Telnyx API Key
      - `connection_id` string, nullable — Telnyx Call Control Application ID (connection_id). If omitted, a Call Control Application is auto-created on save and its id is stored on the configuration.
      - `webhook_public_key` string, nullable — Webhook public key from Mission Control Portal → Keys & Credentials → Public Key. Used to verify Telnyx webhook signatures.
      - `from_numbers` string[] — List of Telnyx phone numbers
    - TwilioConfigurationRequest — Request schema for Twilio configuration.
      - `provider` 'twilio'
      - `account_sid` string, required — Twilio Account SID
      - `auth_token` string, required — Twilio Auth Token
      - `from_numbers` string[] — List of Twilio phone numbers
      - `amd_enabled` boolean — Detect whether outbound calls are answered by a person or machine. Twilio may bill AMD as an additional per-call feature.
    - VobizConfigurationRequest — Request schema for Vobiz configuration.
      - `provider` 'vobiz'
      - `auth_id` string, required — Vobiz Account ID (e.g., MA_SYQRLN1K)
      - `auth_token` string, required — Vobiz Auth Token
      - `application_id` string, nullable — Vobiz Application ID. The application's answer_url is updated when inbound workflows are attached to numbers on this account. If omitted, an application is auto-created on save and its id is stored on the configuration.
      - `from_numbers` string[] — List of Vobiz phone numbers (E.164 without + prefix)
    - VonageConfigurationRequest — Request schema for Vonage configuration.
      - `provider` 'vonage'
      - `api_key` string, required — Vonage API Key
      - `api_secret` string, required — Vonage API Secret
      - `application_id` string, required — Vonage Application ID
      - `private_key` string, required — Private key for JWT generation
      - `signature_secret` string, nullable — Vonage signature secret used to verify signed webhooks
      - `from_numbers` string[] — List of Vonage phone numbers (without + prefix)

## Response `200`

Successful Response

- TelephonyConfigurationDetail — Body of ``GET /telephony-configs/{id}`` — credentials are masked.
  - `id` integer, required
  - `name` string, required
  - `provider` string, required
  - `is_default_outbound` boolean, required
  - `credentials` object, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `404` — Not found
- `422` — Validation Error

---

[API](https://skmtc.net/dograh/apis/dograh-api.md) · [All operations](https://skmtc.net/dograh/apis/dograh-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dograh/dograh-api/revisions/e7d045c0295a/schema)