---
title: "Create SMS Number"
method: POST
path: "/domains/{domain}/smsnumbers"
tags: ["SMS Numbers"]
---

# Create SMS Number

`POST /domains/{domain}/smsnumbers`

## Path parameters

- `domain` string, required — This is the main organization name. This is used to link resource to its group/tenant/organization/enterprise. Then using in path for GET you can set to "~" to use the domain name linked to your token/key instead of the domain name itself when reading for your own domain.

## Request body

- object
  - `number` string, required
  - `application` string, required — This is the application of the number. Can be for a user, callqueue, or available
  - `dest` string — This is the destination for the SMS number if assigned. Can be a user or a call queue
  - `carrier` string — Accepts carrier definition at number creation. Be mindful of formatting here.

## Response `202`

- object
  - `code` integer, required
  - `message` string, required

## Other responses

- `400`
- `401`
- `404`

---

[API](https://skmtc.net/ns-api/apis/netsapiens-api-v2.md) · [All operations](https://skmtc.net/ns-api/apis/netsapiens-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ns-api/netsapiens-api-v2/versions/d37f65b5b886/schema)