Delete User
Purpose
To delete a user from your organization.
Request URL
https://www.zohoapis.com/crm/v2/users
Request Method
DELETE
Scope
scope=ZohoCRM.users.ALL
(or)
scope=ZohoCRM.users.DELETE
Possible operation types |
---|
ALL - Full access to data DELETE - Delete user data |
Note:
You can delete only one user per request.
Request JSON
Attribute | Data Type | Mandatory | Description |
---|---|---|---|
ID | String | Yes | The record ID of the user you want to delete. |
Note:
You can also pass the record ID in the request. Example: {{api-domain}}/crm/v2/users/{{record_id}}
Refer to Get Users API to obtain the record ID of the user.
The deleted user record will also show up in the response when you fetch user records through the Get Users API where the status is set as deleted.
You cannot delete the primary contact of your organization. To delete the primary contact, you must assign another user as the new primary contact of your organization and then delete the old one.
HTTP Status | Error Code | Message | Reason |
---|---|---|---|
200 | invalid_data | the_id_given_seems_to_be_invalid | The record ID of the user you want to delete is invalid. |
400 | invalid_request | Primary contact cannot be deleted | You cannot delete the primary contact of your organization. |
400 | id_already_deleted | User is already deleted | The user you want to delete is already deleted. |
401 | authorization_failed | User does not have sufficient privilege to delete users | The user does not have the permission to delete users. |
Sample Request
Copiedcurl "https://www.zohoapis.com/crm/v2/users/554023000000691003"
-X DELETE
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
Copiedimport java.util.List;
import com.zoho.crm.library.api.APIConstants;
import com.zoho.crm.library.api.response.APIResponse;
import com.zoho.crm.library.api.response.BulkAPIResponse;
import com.zoho.crm.library.common.ZCRMEntity;
import com.zoho.crm.library.crud.ZCRMOrgTax;
import com.zoho.crm.library.crud.ZCRMTax;
import com.zoho.crm.library.setup.metadata.ZCRMOrganization;
import com.zoho.crm.library.setup.restclient.ZCRMRestClient;
import com.zoho.crm.library.setup.users.ZCRMProfile;
import com.zoho.crm.library.setup.users.ZCRMRole;
import com.zoho.crm.library.setup.users.ZCRMUser;
import com.zoho.oauth.client.ZohoOAuthClient;
import com.zoho.oauth.contract.ZohoOAuthTokens;
public class Org{
public Org() throws Exception{
ZCRMRestClient.initialize();
}
public void deleteUser() throws Exception{
ZCRMRestClient client = ZCRMRestClient.getInstance();
ZCRMOrganization org=client.getOrganizationInstance();
APIResponse response=org.deleteUser(554023000000691003L);//554023000000691003L is user id
System.out.println("HTTP status code "+response.getStatusCode());
System.out.println("Status "+response.getStatus());
System.out.println("message "+response.getMessage());
}
public static void main(String[] args) throws Exception {
Org obj=new Org();
obj.deleteUser();
}
}
Copied# Delete user
# -----------
def delete_user(self):
try:
resp = zcrmsdk.ZCRMOrganization.get_instance().delete_user(554023000000691003) # user id
print(resp.status_code)
print(resp.message)
print(resp.code)
print(resp.status)
print(resp.details)
print(resp.data)
except zcrmsdk.ZCRMException as ex:
print(ex.status_code)
print(ex.error_message)
print(ex.error_code)
print(ex.error_details)
print(ex.error_content)
Copied<?php
use zcrmsdk\crm\setup\restclient\ZCRMRestClient;
require 'vendor/autoload.php';
class Org{
public function __construct()
{
$configuration = array("client_id"=>{client_id},"client_secret"=>{client_secret},"redirect_uri"=>{redirect_url},"currentUserEmail"=>{user_email_id});
ZCRMRestClient::initialize($configuration);
}
public function deleteUser(){
$orgIns = ZCRMRestClient::getOrganizationInstance(); // to get the organization instance
$responseIns=$orgIns->deleteUser("554023000000691003");//to delete the user
echo "HTTP Status Code:".$responseIns->getHttpStatusCode(); //To get http response code
echo "Status:".$responseIns->getStatus(); //To get response status
echo "Message:".$responseIns->getMessage(); //To get response message
echo "Code:".$responseIns->getCode(); //To get status code
echo "Details:".json_encode($responseIns->getDetails());
}
}
$obj =new Org();
$obj->deleteUser();
Copied/** To delete a user */
public static void DeleteUser()
{
ZCRMOrganization OrgInstance = ZCRMRestClient.GetInstance().GetOrganizationInstance();
APIResponse response = OrgInstance.DeleteUser(554023000000691003); //user ID
Console.WriteLine(response.HttpStatusCode);
Console.WriteLine(response.Status);
Console.WriteLine(response.ResponseJSON);
Console.WriteLine(response.Message);
Console.WriteLine(JsonConvert.SerializeObject(response));
Console.WriteLine("\n\n\n");
}
Sample Response
Copied{
"users": [
{
"code": "SUCCESS",
"details": {},
"message": "User deleted",
"status": "success"
}
]
}
Copied{
"users": [
{
"code": "SUCCESS",
"details": {},
"message": "User deleted",
"status": "success"
}
]
}
Copied{
"users": [
{
"code": "SUCCESS",
"details": {},
"message": "User deleted",
"status": "success"
}
]
}
Copied{
"users": [
{
"code": "SUCCESS",
"details": {},
"message": "User deleted",
"status": "success"
}
]
}
Copied{
"users": [
{
"code": "SUCCESS",
"details": {},
"message": "User deleted",
"status": "success"
}
]
}
Sample Response
Copied{
"users": [
{
"code": "SUCCESS",
"details": {},
"message": "User deleted",
"status": "success"
}
]
}
Copied{
"users": [
{
"code": "SUCCESS",
"details": {},
"message": "User deleted",
"status": "success"
}
]
}
Copied{
"users": [
{
"code": "SUCCESS",
"details": {},
"message": "User deleted",
"status": "success"
}
]
}
Copied{
"users": [
{
"code": "SUCCESS",
"details": {},
"message": "User deleted",
"status": "success"
}
]
}
Copied{
"users": [
{
"code": "SUCCESS",
"details": {},
"message": "User deleted",
"status": "success"
}
]
}
Sample Response
Copied{
"users": [
{
"code": "SUCCESS",
"details": {},
"message": "User deleted",
"status": "success"
}
]
}
Copied{
"users": [
{
"code": "SUCCESS",
"details": {},
"message": "User deleted",
"status": "success"
}
]
}
Copied{
"users": [
{
"code": "SUCCESS",
"details": {},
"message": "User deleted",
"status": "success"
}
]
}
Copied{
"users": [
{
"code": "SUCCESS",
"details": {},
"message": "User deleted",
"status": "success"
}
]
}
Copied{
"users": [
{
"code": "SUCCESS",
"details": {},
"message": "User deleted",
"status": "success"
}
]
}
Sample Response
Copied{
"users": [
{
"code": "SUCCESS",
"details": {},
"message": "User deleted",
"status": "success"
}
]
}
Copied{
"users": [
{
"code": "SUCCESS",
"details": {},
"message": "User deleted",
"status": "success"
}
]
}
Copied{
"users": [
{
"code": "SUCCESS",
"details": {},
"message": "User deleted",
"status": "success"
}
]
}
Copied{
"users": [
{
"code": "SUCCESS",
"details": {},
"message": "User deleted",
"status": "success"
}
]
}
Copied{
"users": [
{
"code": "SUCCESS",
"details": {},
"message": "User deleted",
"status": "success"
}
]
}