Update SMS number

PUT

/domains/{domain}/smsnumbers/{smsnumber}

Last modified:2026-10-09 00:40:58

OperationId:UpdateSMSNumber

Changes the assignment, carrier, or note of an SMS number in the domain in the path.

Requires Office Manager, Site Manager, Call Center Supervisor, Route Manager, Reseller, or Super User scope. A Site Manager changes only numbers routed to users in its own site, and can assign them only to users in its site.

Send application on every update, even when you change only carrier or notes. Fields you leave out keep their values. Setting application to available releases the number to the pool and clears dest. Reassigning a number moves it from the old user's messaging profile to the new one's.

A number that is not in this domain returns 404. A 202 means the change is accepted and applied shortly after. Read it back with GET /domains/{domain}/smsnumbers/{smsnumber}.

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

Accepted. The change is applied shortly after. Read the number back to confirm.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠404Record not found

Request Example

Shell

JavaScript

Java

Swift

cURL

Reassign to a userRelease to the poolChange carrier

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

Response Example

202 - Accepted

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

Modified at 2026-10-09 00:40:58

List SMS numbers

Delete SMS number