---
title: "Create Phone Channel"
method: POST
path: "/v1/channels/phone"
tags: ["Phone channel global"]
---

# Create Phone Channel

`POST /v1/channels/phone`

## Request body

- CreatePhoneConfig
  - `name` string, required
  - `description` string, nullable
  - `service_provider` 'sip_trunk' | 'genesys_audio_connector'
  - `custom_invite_headers` CustomInviteHeader[], nullable
    - `name` string, required
  - `put_caller_on_hold_on_transfer` boolean, nullable
  - `send_provisional_response` boolean, nullable
  - `security` PhoneSecurity, required
    - `api_key` string, nullable
    - `client_secret` string, nullable
    - `secure_trunking` boolean, nullable
    - `authentication` boolean, nullable
    - `username` string, nullable
    - `password` string, nullable
    - `password_is_set` boolean, nullable
  - `error_handling` PhoneErrorHandling
    - `fallback_sip_uri` string, nullable
    - `transfer_failure` PhoneErrorTransferFailureHandling
      - `reply_message` string, nullable
      - `disconnect_call` boolean, nullable
    - `call_failure` PhoneErrorCallFailureHandling
      - `reply_message` string, nullable

## Response `201`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

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