---
title: "Create"
method: POST
path: "/api/cp/switch/user"
tags: ["SIP User"]
---

# Create

`POST /api/cp/switch/user`

Create a new SIP User record.

## Request body

- SipUserInput
  - `id` integer — Id
  - `company_id` integer — Company Id (references company.id)
  - `username` string — Username
  - `password` string, password — Password
  - `bandwidth` integer — Bandwidth
  - `channels` integer — Channels
  - `cps` integer — Cps
  - `protocol` string — Protocol
  - `codec` string — Codec
  - `dial_pattern` string — Dial Pattern
  - `prefix` string — Prefix
  - `cli_prefix` string — Cli Prefix
  - `strip` integer, required — Strip
  - `status` integer, required — Status
  - `rewrite` object — Rewrite
  - `voicemail` integer, required — Voicemail
  - `voicemail_password` string, password, required — Voicemail Password
  - `ip_whitelist` string — Ip Whitelist
  - `email` string, email — Email
  - `sip_ping` integer, required — Sip Ping
  - `smart` integer, required — Smart
  - `retain_did` integer, required — Retain Did
  - `sip_profile_id` integer — Sip Profile Id
  - `address_number` string — Address Number
  - `street_name` string — Street Name
  - `city` string — City
  - `state` string — State
  - `post_code` string — Post Code

## Response `200`

Successful response

- CreateResponse
  - `id` union — The ID of the newly created record
    - integer
    - string
  - `status` string — Operation status

## Other responses

- `400` — Bad Request - Invalid parameters or request body
- `401` — Authentication information is missing or invalid
- `403` — Access denied - insufficient permissions or dependency access failure
- `409` — Conflict - foreign key or unique constraint violation on write
- `500` — Internal server error

---

[API](https://skmtc.dev/connexcs/apis/connexcs-control-panel-api.md) · [All operations](https://skmtc.dev/connexcs/apis/connexcs-control-panel-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/connexcs/connexcs-control-panel-api/revisions/54bc2ed6edae/schema)