Creates a static unique custom group (groupCategory=5) with explicit member resources. Only computer-type static unique groups are supported — user-type static unique groups are not allowed. Static Unique groups are used for Scope of Management — they enforce that each resource belongs to only ONE static unique group of the same type, enabling non-overlapping technician territories. Unlike regular Static groups where a resource can belong to multiple groups, Static Unique groups reject any resource already in another Static Unique group. Required: groupName, groupType=1, groupCategory=5, resourceIds. Prerequisites: Call Get Available Resources to discover valid resource IDs.
post /api/1.4/customgroup/addCg
https://{serverurl}/api/1.4/customgroup/addCg
DesktopCentralCloud.Common.UPDATECopied!
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Must be application/json. Request body must be valid JSON.
Must be application/json. Only JSON responses are supported.
Name for the new group. Must be unique. Max 100 chars.
Forbidden characters: ` \ : ; < > ? * " | & # % /
Must be 5 for static unique groups.
Must be 1 (Computers). Static unique custom groups only support computer-type — user-type static unique groups are not supported.
Group description. Max 250 chars. Double quotes not allowed.
Array of resource IDs. Members must be exclusive — each resource can only belong to ONE static unique group of the same type. Resources already in another static unique group will be reported in invalidResourceIds. Fetch IDs from Get Available Resources.
curl --request POST \
--url https://appdomain/api/1.4/customgroup/addCg \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{"groupName":"Privileged Servers","groupType":1,"groupCategory":5,"resourceIds":[101,102]}'Create a static unique computer group with exclusive members.
{
"groupName": "Privileged Servers",
"groupType": 1,
"groupCategory": 5,
"description": "Servers with restricted technician access",
"resourceIds": [
101,
102
]
}
Always 'addCg' for this endpoint.
Response payload container.
Response payload.
Newly assigned resource ID (returned as string). Use as cgId in Delete CG, or as groupId in the request body of Update Static CG or Update Static Unique CG.
Name of the created group (echoed from request).
Numeric category as string: '1'=Static, '5'=Static Unique.
Group type as numeric string: '1' for Computers, '2' for Users. NOT the display name.
[Conditional] Array of resource IDs that were not found or not valid. Present only when some submitted resourceIds are invalid.
API version: '1.4'.
'success' when the request completed without errors.
Always 'addCg' for this endpoint.
API version: '1.4'.
Always 'error' for error responses.
'70501' (CG_CREATE_UPDATE_PARAMS_MISSING), '70502' (CG_DUPLICATE_NAME), '70504' (CG_INVALID_GROUP_TYPE), '70505' (CG_INVALID_GROUP_CATEGORY), '70503' (CG_NULL_CRITERIA_PATTERN), '70517' (CG_INVALID_CRITERIA_PATTERN), '70508' (CG_MORE_COMPUTERS_DUMMY_CG), '70513' (CG_INVALID_CREATION_MODE).
Resolved I18N message varies by error code: 'Required parameters are missing to create/update Custom Group.' (70501), 'Custom group name is already in use.' (70502), 'Invalid group type.' (70504), 'Invalid group category.' (70505), 'Criteria pattern is empty.' (70503), 'Invalid criteria pattern.' (70517), 'Computer limit exceeded for free edition.' (70508), 'Only manually created Custom Group is allowed to be accessed using external apis.' (70513).
Always 'addCg' for this endpoint.
API version: '1.4'.
Always 'error' for error responses.
Internal error code: '1003' (INTERNAL_ERROR).
Resolved I18N message, typically: An internal error occurred while processing the request.
Static unique group created with assigned resource ID.
{
"message_type": "addCg",
"message_response": {
"addcg": {
"groupName": "Privileged Servers",
"groupType": "1",
"groupCategory": "5",
"cgResourceId": "310"
}
},
"message_version": "1.4",
"status": "success"
}
Static unique group created but some exclusive member resource IDs were not found.
{
"message_type": "addCg",
"message_response": {
"addcg": {
"groupName": "Privileged Servers",
"groupType": "1",
"groupCategory": "5",
"invalidResourceIds": [
999,
998
],
"cgResourceId": "310"
}
},
"message_version": "1.4",
"status": "success"
}
A group with this name already exists.
{
"error_description": "Custom group name is already in use.",
"message_type": "addCg",
"error_code": "70502",
"message_version": "1.4",
"status": "error"
}
Unexpected server-side failure during group creation.
{
"error_description": "An internal error occurred while processing the request.",
"message_type": "addCg",
"error_code": "1003",
"message_version": "1.4",
"status": "error"
}
![]()
Duration: 1 minute | Threshold: 30 | Lock period: 5 minutes
Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.