Create a Service Code

POST

/servicecode

Last modified:2026-07-28 22:52:31

OperationId:createServiceCode

Creates one service-code row. srvcode-code and domain are required; srvcode-item defaults to *.

Pass domain = * to create a system-wide code (Super User territory).

The key triple is checked first: a create over an existing (srvcode-item, srvcode-code, domain) returns 409 instead of overwriting the existing description. Use PUT /servicecode/{type}/{code} to edit.

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

🟢201Created

Created (no body)

This response does not have a body.

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠409

Request Example

Shell

JavaScript

Java

Swift

cURL

Domain-specific codeMinimal create (srvcode-item defaults to *)System-wide code shared by every tenantMissing domain → expect 400srvcode-code over 31 chars → expect 400Existing key triple → expect 409

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

Response Example

400 - Write without a domain

{
    "code": 400,
    "message": "Bad request. Missing parameter 'domain'."
}

Modified at 2026-07-28 22:52:31

List Service Codes

Count Service Codes