Create service code

POST

/servicecode

Last modified:2026-10-06 16:24:30

OperationId:createServiceCode

Creates a service code for the domain in domain, or a system-wide code that every domain shares when domain is *. domain is required: a write without it returns 400. Send "domain": "*" to address a system-wide code, which needs Super User scope.

Requires Office Manager scope or above for your own domain, Reseller scope for the domains in your territory, or Super User scope for any domain. System-wide codes, with domain *, are shared by every domain. Only Super User scope can create, change, or delete them. Any other scope gets 403.

srvcode-code is required. srvcode-item defaults to *. Codes that start with system- are the platform's own, such as system-aa and system-queue. Name your own codes without that prefix. Use only letters, digits, and * # . - _ in srvcode-code and srvcode-item, because the paths that read, change, and delete a code accept nothing else.

A code with the same type, code, and domain returns 409. Change it with PUT /servicecode/{type}/{code} instead. A 202 means the change is accepted and applied shortly after. For a domain's own codes, POST /domains/{domain}/servicecode puts the domain in the path.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢202Accepted

application/json

The change is accepted and applied shortly after this response.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠409Conflict

Request Example

Shell

JavaScript

Java

Swift

cURL

Domain codeSystem-wide code (Super User)

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/servicecode' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "srvcode-code": "hotdesk",
    "domain": "example.com",
    "srvcode-description": "Hot desk user"
}'

Response Example

202 - Accepted

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

Modified at 2026-10-06 16:24:30

List service codes

Count service codes