Deleting groups in the Zoho Desk Help Center involves three distinct API operations depending on your goal: removing a single user from their groups, removing multiple users from a specific group, or permanently deleting the group itself. Here's how each works.
---
Why this matters
Help Center groups control which customers or community members can access specific content and portals. As your support structure evolves, you may need to clean up stale groups, offboard users from communities, or restructure access tiers. Knowing which endpoint to call — and in what order — prevents orphaned memberships and keeps your Help Center permissions tidy. *(Beam Help is independent expert support for Zoho — not official Zoho support.)*
---
Step-by-step
Step 1. Identify your helpcenter_id and the relevant IDs.
Before making any deletion call, gather the IDs you'll need. Every Help Center group operation requires a helpcenterid. Depending on what you're deleting, you'll also need either a userid, a group_id, or both. These can be retrieved via the corresponding GET endpoints for your Help Center.
---
Step 2. (Optional) Remove a specific user from all their groups.
If your goal is to detach one user from every group they belong to — without touching the groups themselves — issue a DELETE request to:
DELETE /api/v1/helpcenter/{helpcenter_id}/users/{user_id}/groupsPass the helpcenterid and userid as path parameters, along with any filter payload p as needed. This operation targets the user's group memberships rather than the groups themselves. [1]
---
Step 3. (Optional) Remove one or more users from a specific group.
When you want to clear members out of a particular group — but keep the group intact — call:
DELETE /api/v1/helpcenter/{helpcenter_id}/groups/{group_id}/usersSupply the helpcenterid and groupid in the path. The optional p parameter can carry a body payload specifying which users to remove. This is useful for bulk membership cleanup before a group is retired. [2]
---
Step 4. Delete the group permanently.
Once the group is empty or you're ready to remove it entirely, send a DELETE request to:
DELETE /api/v1/helpcenter/{helpcenter_id}/groups/{group_id}Both helpcenterid and groupid are required path parameters. An optional p dict can be passed for additional query parameters. This call permanently removes the group from your Help Center. [3]
In Python, the call looks like this:
desk_api.delete_group(helpcenter_id="your_hc_id", group_id="your_group_id")---
Step 5. Confirm your OAuth scopes are sufficient.
All Help Center management operations require that your connected OAuth token includes the appropriate Zoho Desk scopes. At minimum, ensure your token carries Desk.settings.DELETE (for destructive operations) and Desk.settings.READ (to look up IDs beforehand). Without these scopes, the API will return an authorisation error. [4]
---
Common pitfalls
- Deleting a group with active members: If you skip Step 3 and go straight to deleting the group, existing user-to-group associations may cause unexpected behaviour. We recommend clearing members first using the
removeusersfromgroupendpoint before callingdeletegroup. [^2, ^3]
- Confusing Desk Help Center groups with CRM user groups: Zoho CRM has its own separate group management endpoint (
DELETE /settings/usergroups/{ugid}) that is entirely distinct from Help Center groups. Make sure you're calling the correct API for your product. [7]
- Missing path parameters: All three Help Center group endpoints require both
helpcenteridand at least one ofuseridorgroup_idin the URL path. Omitting either will result in a routing error rather than a meaningful API response. [^1, ^2, ^3]
---
What to check
- Verify the group no longer appears by calling the corresponding GET endpoint for your Help Center groups after deletion.
- Confirm user memberships are cleared — check that affected users no longer have the deleted group listed under their Help Center profile.
- Review OAuth token scopes to ensure
Desk.settings.DELETEis present and the token hasn't expired before running any of these operations. [4]