Add domain blocked numbers

POST

/domains/{domain}/number-filters

Last modified:2026-10-09 00:28:55

OperationId:AddBlockedNumbersForDomain

Adds numbers to the domain's blocked-number list, kept on the domain's system user domain.

Requires Office Manager scope for your own domain, or Reseller or Super User scope.

Send the numbers in phone-numbers-to-reject.parameters. Each one is added to the list, or updated if it is already there. Numbers you leave out stay on the list. A single number in place of the list is taken as a one-item list.

To pause or resume the whole list, send phone-numbers-to-reject with enabled set to no or yes and an empty parameters list. Every number already on the list takes that setting.

The list always belongs to the default answering rule. A time-frame in the request is ignored. A 202 means the change is accepted and applied shortly after. PUT on the same path behaves the same way.

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 list again to see the result.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠404Record not found

Request Example

Shell

JavaScript

Java

Swift

cURL

Add numbersPause the listResume the list

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//number-filters' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "phone-numbers-to-reject": {
        "parameters": [
            "15555550101",
            "15555550102"
        ]
    }
}'

Response Example

202 - Accepted

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

Modified at 2026-10-09 00:28:55

Read domain blocked numbers

Remove domain blocked numbers