Delete SMS number

DELETE

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

Last modified:2026-10-09 00:41:02

OperationId:DeleteSMSNumber

Removes an SMS number from the domain in the path. The user it was assigned to stops receiving messages on it, and the number leaves that user's messaging profile.

Requires Reseller or Super User scope. To take a number out of service without deleting it, set application to available with PUT /domains/{domain}/smsnumbers/{smsnumber}.

A number that is not in this domain returns 404. A 202 means the deletion is accepted and applied shortly after. Once deleted, the number can be added to another domain.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Responses

🟢202Accepted

application/json

Accepted. The number is removed shortly after.

Bodyapplication/json

🟠401Authentication Required

🟠403Forbidden

🟠404Record not found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//smsnumbers/15555550100' \
--header 'Authorization: Bearer <token>'

Response Example

202 - Accepted

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

Modified at 2026-10-09 00:41:02

Update SMS number

List user SMS numbers