---
title: "create voip carrier"
method: POST
path: "/VoipCarriers"
tags: ["Carriers"]
---

# create voip carrier

`POST /VoipCarriers`

## Request body

- object
  - `name` string, required — voip carrier name
  - `description` string
  - `account_sid` string
  - `application_sid` string
  - `e164_leading_plus` boolean — whether a leading + is required on INVITEs to this provider
  - `requires_register` boolean — wehther this provider requires us to send a REGISTER to them in order to receive calls
  - `register_use_tls` boolean — wehther this provider requires us to send a REGISTER use TLS protocol
  - `register_username` string — sip username to authenticate with, if registration is required
  - `register_sip_realm` string — sip realm to authenticate with, if registration is required
  - `register_password` string — sip password to authenticate with, if registration is required
  - `register_from_user` string — optional username to apply in From header
  - `register_from_domain` string — optional domain to apply in From header
  - `register_public_ip_in_contact` boolean — if true, use our public ip in Contact header; otherwise, use sip realm
  - `tech_prefix` string — prefix to be applied to the called number for outbound call attempts
  - `inbound_auth_username` string — challenge inbound calls with this username/password if supplied
  - `inbound_auth_password` string — challenge inbound calls with this username/password if supplied
  - `diversion` string — Diversion header or phone number to apply to outbound calls

## Response `201`

voip carrier successfully created

- SuccessfulAdd
  - `sid` string, required

## Other responses

- `400` — bad request
- `422` — unprocessable entity
- `500` — system error

---

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