Clones an existing dynamic custom group by copying its criteria pattern to a new group with the specified name and description. Only computer-type dynamic groups can be cloned via this endpoint — static, static-unique, and user-type dynamic groups are not supported (dynamic custom groups only support computer-type; user-type dynamic groups do not exist). The source group must exist and be accessible to the caller. The new group name must not already exist. Members of the cloned group are populated by re-evaluating the copied criteria, not by copying members from the source. Prerequisites: Call Retrieve All Custom Groups to look up the sourceCGId of the dynamic group you want to clone (filter for group_category='Dynamic' in the returned cg_list).
post /api/1.4/customgroup/dynamic/clone
https://{serverurl}/api/1.4/customgroup/dynamic/clone
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 cloned group. Max 100 chars. Must be unique.
Description. Max 250 chars.
Resource ID of the source dynamic group. Must exist, be dynamic, and be accessible. Fetch from Retrieve All Custom Groups.
curl --request POST \
--url https://appdomain/api/1.4/customgroup/dynamic/clone \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{"groupName":"Windows 11 PCs - Copy","sourceCGId":302}'Clone a dynamic group, copying all its criteria to a new group.
{
"groupName": "Windows 11 PCs - Copy",
"sourceCGId": 302,
"description": "Cloned from Windows 11 PCs for testing"
}
Always 'dynamic' for this endpoint.
Response payload container.
Response payload.
Newly assigned resource ID for the cloned group (returned as string). Use as cgId in Delete CG, or as groupId in the request body of Update Dynamic CG.
Name of the cloned group (echoed from request).
Always 2 (Dynamic, returned as integer not string) — only dynamic groups can be cloned. Note: addCg returns this as string '2'.
Always 'Computer' (display name, not numeric). Note: addCg returns this as numeric string '1'. Only computer-type dynamic groups can be cloned.
API version: '1.4'.
'success' when the request completed without errors.
Always 'dynamic' for this endpoint.
API version: '1.4'.
Always 'error' for error responses.
'70506' (CG_INVALID_DETAILS_TO_UPDATE).
Resolved I18N message: 'No such Custom Group found.'.
Always 'dynamic' for this endpoint.
API version: '1.4'.
Always 'error' for error responses.
'70502' (CG_DUPLICATE_NAME).
Resolved I18N message: 'Custom group name is already in use.'.
Always 'dynamic' 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.
New group created with same criteria as source.
{
"message_type": "dynamic",
"message_response": {
"dynamic": {
"groupName": "Windows 11 PCs - Copy",
"groupType": "Computer",
"groupCategory": 2,
"cgResourceId": "305"
}
},
"message_version": "1.4",
"status": "success"
}
sourceCGId does not exist, is not dynamic, or user lacks access.
{
"error_description": "No such Custom Group found.",
"message_type": "dynamic",
"error_code": "70506",
"message_version": "1.4",
"status": "error"
}
A group with this name already exists.
{
"error_description": "Custom group name is already in use.",
"message_type": "dynamic",
"error_code": "70502",
"message_version": "1.4",
"status": "error"
}
Unexpected server-side failure during clone.
{
"error_description": "An internal error occurred while processing the request.",
"message_type": "dynamic",
"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.