Create domain dial policy rule

POST

/domains/{domain}/dialpolicy/{policy}/permission

Last modified:2026-10-08 23:01:49

OperationId:CreatePermissionDomain

Adds a rule to a dial policy the domain can use and publishes it over the service bus (SBUS). A rule matches a dialed destination in permission-match and either permits or denies the call (permission-mode).

The name resolves to the domain's own policy first, then to the shared one under * or admin-only, and the rule is filed under the resolved policy's domain. Requires Office Manager scope or higher for a policy the domain owns; a Reseller needs the domain in its territory. A shared policy, one filed under * or admin-only, changes dialing for every domain, so any write to it requires Super User scope.

Send permission-match, permission-mode and permission-reason. In permission-match, ? matches one character and * matches any run of characters. A 202 means the rule was published, not yet applied. Add synchronous=yes to wait up to 2 seconds for this server to show the rule: the answer is then 200 with the rule, or still 202.

A policy that the domain cannot see answers 404.

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

🟢200Accepted

application/json

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

Bodyapplication/json

🟢202OK

🟠400Bad Request

🟠401Authentication Required

🟠404Record not found

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//dialpolicy//permission' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "permission-match": "sip:+1900???????@*",
    "permission-mode": "deny",
    "permission-reason": "Premium rate",
    "synchronous": "yes"
}'

Response Example

200 - Deny premium numbers

Answer to synchronous=yes.

{
    "dialpolicy": "No Premium",
    "domain": "example.com",
    "permission-match": "sip:+1900???????@*",
    "permission-mode": "deny",
    "permission-reason": "Premium rate",
    "created-datetime": "2026-09-01T14:30:00Z",
    "permission-id": "c2lwOisxOTAwPz8_Pz8_P0Aq"
}

Modified at 2026-10-08 23:01:49

Create shared dial policy rule

Update shared dial policy rule