Create domain route profile

POST

/domains/{domain}/routeprofiles

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

OperationId:createDomainRouteProfile

Creates a route profile in the domain, together with its route and route connections from call-routing. Requires Office Manager, Route Manager, or Call Center Supervisor scope in the domain, Reseller scope in its territory, or Super User scope. A failed create leaves nothing behind, so it is always safe to retry.

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/jsonRequired

Examples

Responses

🟢200

application/json

Returned for synchronous=yes, sent in the body or the query string, when the profile is applied within 2 seconds: the route profile. If it takes longer, you get 202 and the write still completes.

Bodyapplication/json

🟢202Accepted

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠404Not Found

🟠409Conflict

Request Example

Shell

JavaScript

Java

Swift

cURL

Two-carrier splitWait for the profile

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//routeprofiles' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "connection-orig-match-pattern": "tollfree",
    "description": "Toll-free outbound chain",
    "call-routing": {
        "route-method": "percentage",
        "routecon": [
            {
                "route-connection-ordinal-index": 1,
                "route-connection-translation-destination-host": "carrier1.example.com",
                "route-connection-integer-percentage": 60
            },
            {
                "route-connection-ordinal-index": 2,
                "route-connection-translation-destination-host": "carrier2.example.com",
                "route-connection-integer-percentage": 40
            }
        ]
    }
}'

Response Example

200 - Wait for the profile

The applied route profile.

{
    "connection-id": "dG9sbGZyZWU",
    "connection-orig-match-pattern": "tollfree",
    "connection-term-match-pattern": "tollfree",
    "domain": "example.com",
    "description": "Toll-free outbound chain",
    "connection-usage-role": "customer",
    "connection-connectivity-type": "route_profile",
    "call-routing": {
        "route-destination-match-pattern": "EXAMPLE.COM_tollfree",
        "route-source-match-pattern": "*",
        "route-class": "*",
        "route-match-server-hostname": "*",
        "route-is-enabled": "yes",
        "description": "Toll-free outbound chain",
        "route-method": "percentage",
        "routecon": [
            {
                "route-connection-ordinal-index": 1,
                "route-connection-translation-destination-user": "[*]",
                "route-connection-translation-destination-host": "carrier1.example.com",
                "route-connection-integer-percentage": 60,
                "route-connection-integer-cost": 0
            },
            {
                "route-connection-ordinal-index": 2,
                "route-connection-translation-destination-user": "[*]",
                "route-connection-translation-destination-host": "carrier2.example.com",
                "route-connection-integer-percentage": 40,
                "route-connection-integer-cost": 0
            }
        ]
    }
}

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

List domain route profiles

Read domain route profile