Create domain service code

POST

/domains/{domain}/servicecode

Last modified:2026-10-09 01:01:01

OperationId:createDomainServiceCode

Creates a service code for the domain in the path. 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.

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.

A code with the same type, code, and domain returns 409. Change it with PUT /domains/{domain}/servicecode/{type}/{code} instead. A 202 means the change is accepted and applied shortly after. Returns 404 when the domain does not exist. To create a system-wide code, use POST /servicecode with domain *.

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

🟢202Accepted

application/json

The change is accepted and applied shortly after this response.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠409Conflict

Request Example

Shell

JavaScript

Java

Swift

cURL

Create a codeCreate a code with a type

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

Response Example

202 - Accepted

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

Modified at 2026-10-09 01:01:01

List domain service codes

Count domain service codes