Create dial policy

POST

/dialpolicy

Last modified:2026-09-26 18:04:31

OperationId:CreateDialpolicy

Creates a dial policy and publishes it over the service bus (SBUS). Send dialpolicy and description, and domain to file the policy under one domain.

Omit domain, or send * or admin-only, to create a shared policy that every domain can use. Shared policies require Super User scope. A Reseller can create a policy for a domain in its territory; any other domain answers 403.

A 202 means the change was published, not yet applied. Add synchronous=yes to wait up to 2 seconds for this server to show the policy: the answer is then 200 with the policy, or still 202 if it did not appear in time.

A policy with the same name under the domain, * or admin-only answers 409: choose another name. The name may contain only letters, digits, spaces, ., &, - and _, or the policy cannot be addressed by path later. To create a policy for one domain, you can also use POST /domains/{domain}/dialpolicy.

Add rules with POST /domains/{domain}/dialpolicy/{policy}/permission, or POST /dialpolicy/{policy}/permission for a shared policy.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

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

🟠400

🟠401

🟠403Forbidden

🟠409Conflict

Request Example

Shell

JavaScript

Java

Swift

cURL

Domain policyShared policy

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

Response Example

200 - Domain policy

Answer to synchronous=yes.

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

Modified at 2026-09-26 18:04:31

Read domain dial policy rule

Update shared dial policy