---
title: "Create a customer phone server for self-hosted call media"
method: POST
path: "/v1/phone-servers"
---

# Create a customer phone server for self-hosted call media

`POST /v1/phone-servers`

## Request

- Base URL: `https://api.skysay.ai`
- URL: `https://api.skysay.ai/v1/phone-servers`
- Auth: none declared

## Request body

- PhoneServer
  - `allowed_sip_ips` string[]
  - `auth_mode` 'ip_allowlist' | 'sip_credentials' | 'ip_allowlist_and_credentials'
  - `metadata` object
  - `name` string: Customer-facing label, e.g. My phone server.
  - `organization_id` string, required
  - `password_reference` string: Reference to an external secret; plaintext passwords are not returned.
  - `port` integer
  - `project_id` string
  - `server_address` string, required: Hostname or public IP of the customer's phone server.
  - `transport` 'udp' | 'tcp' | 'tls'
  - `username` string

## Response `201`

Phone server

---

[API](https://skmtc.dev/skysay/apis/skysay-api.md) · [All operations](https://skmtc.dev/skysay/apis/skysay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skysay/apis/skysay-api/revisions/148c7e111260?raw)