Transfer Users and Delete a Profile

Purpose

To transfer the users to a new profile and delete the old one.

Endpoints

DELETE /settings/profiles/{profile_ID}?transfer_to={existing_profile_ID}

Request Details

Request URL

{api-domain}/crm/{version}/settings/profiles/{profile_id}
Where, profile-id is the unique ID of the profile you want to delete.
existing_profile_id is the unique ID of the existing profile you want to transfer the users to.

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Scope

ZohoCRM.settings.profiles.ALL
(or)
ZohoCRM.settings.profiles.DELETE

Parameters

transfer_tonumber, mandatory
The unique ID of the profile to which you want to transfer the records from the old profile.

Sample Request

Copiedcurl "https://www.zohoapis.com/crm/v8/settings/profiles/3652397000009592005?transfer_to=3652397000000026011"
-X DELETE
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

Possible Errors

REQUIRED_PARAM_MISSINGHTTP 400
You have not included the transfer_to parameter
Resolution: The transfer_toparameter is mandatory to transfer the users to the new profile and delete the old one. Use the Get Profiles API to get the ID of the profile you want to transfer the users to.
INVALID_DATAHTTP 400
The profile ID provided is either incorrect or has already been deleted.
Resolution: Specify a valid profile ID. Use the Get Profiles API to get the ID of the profile you want to transfer the users to.

Sample Response

Copied{
    "code": "SUCCESS",
    "details": {},
    "message": "Profile deleted",
    "status": "success"
}