Create phone template

POST

/domains/{domain}/phonetemplates

Last modified:2026-10-30 21:20:56

OperationId:CreatePhoneTemplateDomain

Creates a phone template in the domain: a named button layout for one phone brand and model that the phone template builder can apply to phones. Requires Office Manager, Reseller, or Super User scope. To lay out one phone by MAC address, use POST /domains/{domain}/phoneconfiguration instead.

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

The change is accepted and already applied.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠409Conflict

Request Example

Shell

JavaScript

Java

Swift

cURL

Template with a queue toggleTemplate with a time frame toggle

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//phonetemplates' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "phoneconfiguration-name": "Front Desk WP826",
    "phoneconfiguration-description": "Front desk layout with queue toggle",
    "phoneconfiguration-brand": "Grandstream",
    "phoneconfiguration-model": "WP826",
    "phoneconfiguration-directory": {
        "group": "All",
        "group-type": "Standard",
        "sort": "Extension",
        "order": "asc",
        "exclusions": [
            {
                "id": "1009@example.com",
                "type": "onnet"
            }
        ]
    },
    "phoneconfiguration-buttons": [
        {
            "phoneconfiguration-button-order": 1,
            "phoneconfiguration-button-type": "line_only",
            "phoneconfiguration-button-feature": "line",
            "phoneconfiguration-button-target": "1001",
            "phoneconfiguration-button-label": "Line 1",
            "phoneconfiguration-button-locked": 0,
            "phoneconfiguration-extra": {}
        },
        {
            "phoneconfiguration-button-order": 2,
            "phoneconfiguration-button-type": "line_only",
            "phoneconfiguration-button-feature": "line",
            "phoneconfiguration-button-target": "1001",
            "phoneconfiguration-button-label": "Line 2",
            "phoneconfiguration-button-locked": 0,
            "phoneconfiguration-extra": {}
        },
        {
            "phoneconfiguration-button-order": 4,
            "phoneconfiguration-button-type": "mpk",
            "phoneconfiguration-button-feature": "queue_status",
            "phoneconfiguration-button-target": "",
            "phoneconfiguration-button-label": "Queue",
            "phoneconfiguration-button-locked": 1,
            "phoneconfiguration-extra": {}
        }
    ]
}'

Response Example

202 - Accepted

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

Modified at 2026-10-30 21:20:56

Count phone templates

Update phone template