Create domain dial policy

POST

/domains/{domain}/dialpolicy

Last modified:2026-10-30 21:29:28

OperationId:CreateDialpolicyInDomain

Creates a dial policy filed under the domain in the path. A dial policy is a named set of permit and deny rules that decides which numbers a user may call. Requires Super User scope, or Reseller scope for a domain in its territory. To create a shared policy, use POST /dialpolicy.

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

🟢200OK

application/json

Returned instead of 202 when synchronous=yes and the policy appeared within 2 seconds: the new policy.

Bodyapplication/json

🟢202Accepted

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠409

Request Example

Shell

JavaScript

Java

Swift

cURL

Domain policyPublished only

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//dialpolicy' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "dialpolicy": "No Premium",
    "description": "Blocks 900 numbers",
    "synchronous": "yes"
}'

Response Example

200 - Domain policy

{
    "dialpolicy": "No Premium",
    "domain": "example.com",
    "description": "Blocks 900 numbers"
}

Modified at 2026-10-30 21:29:28

List domain dial policy rules, reduced

List SMS blocks