Create SMS number

POST

/domains/{domain}/smsnumbers

Last modified:2026-10-30 20:52:58

OperationId:CreateSMSNumber

Adds an SMS number to the domain and assigns it to a user, a call queue, or the domain's pool of available numbers. Requires Office Manager, Call Center Supervisor, Route Manager, Reseller, or Super User scope.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/json

Examples

Responses

🟢202Accepted

application/json

The change is accepted and applied shortly after. Read the number back with GET /domains/{domain}/smsnumbers/{smsnumber} to confirm.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠404Record not found

🟠409Conflict

Request Example

Shell

JavaScript

Java

Swift

cURL

Assign to a userAssign to a call queueHold as available

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//smsnumbers' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "number": "15555550100",
    "application": "user",
    "dest": "1001",
    "carrier": "bandwidth"
}'

Response Example

202 - Accepted

{
    "code": 202,
    "message": "Accepted"
}

Modified at 2026-10-30 20:52:58

List domain SMS numbers

List SMS numbers