Permanently deletes a user account identified by the login ID from the organization. All active sessions are terminated immediately upon deletion.
delete /dcapi/users-cloud/{userId}
https://{serverurl}/dcapi/users-cloud/{userId}
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Specifies the request payload format. Set to application/userDeletion.v1+json to get the response format after user data deletion in JSON format.
Unique user identifier. To get user id click here. Get User Id
curl --request DELETE \
--url https://appdomains/dcapi/users-cloud/{userId} \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'accept: application/userDeletion.v1+json'Confirmation message indicating successful user deletion.
{
"statusMsg": "User john.smith has been deleted successfully"
}
![]()
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.