- Overview
- What's New in V8?
- Changelog
- Open API Specification 3.0.0 (OAS)
- API Directory
- API Collection
- APIs and References
- OAuth
- API Limits and Credits
- Compliance
- Zoho CRM SDKs
- Metadata APIs
- Customization
- Process Automation
- Security control
- Roles
- Profiles
- Territories
- GETTerritories
- POSTTerritories
- PUTTerritories
- DELETETerritories
- POSTTransfer and Delete Territories
- GETChild Territories of a Territory
- GETTerritories Assigned
- GETAssociated User Count
- GETRetrieve User details Associated with a Territory
- PUTAssociate Users with Territory
- POSTRemove Territories of Records
- POSTAssign Territories to Records
- DELETEDisassociate Users from Territory
- Export Audit Log
- Portals
- Data Sharing
- Company Settings
- Zia
- Core APIs
- Records
- Merge Records
- Share Records
- Mail Merge
- Services
- Appointments
- Appointments Rescheduled History
- Fields Attachments
- Meeting Cancel
- Notes
- Mass Actions
- Related Records
- External ID
- Emails
- Subforms
- Linking Modules
- Others
- Bulk APIs
- Composite API
- Query API
- Notification APIs
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"
}© 2025, Zoho Corporation Pvt. Ltd. All Rights Reserved.