---
title: "provision a phone number into inventory from a Voip Carrier"
method: POST
path: "/PhoneNumbers"
tags: ["Phone Numbers"]
---

# provision a phone number into inventory from a Voip Carrier

`POST /PhoneNumbers`

## Request body

- object
  - `account_sid` string, uuid
  - `application_sid` string, uuid
  - `number` string, required — telephone number
  - `voip_carrier_sid` string, uuid, required

## Response `201`

phone number successfully provisioned

- SuccessfulAdd
  - `sid` string, required

## Other responses

- `400` — bad request
- `404` — voip carrier not found
- `422` — unprocessable entity
- `500` — system error

---

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