- Overview
- What's New in V5?
- Changelog
- API Collection
- OAuth Authentication
- API Limits
- Multi DC Support
- Increase API Credits
- Customize API Usage Notification
- GDPR Compliance
- HIPAA Compliance
- API Dashboard
- HTTP Request Methods
- Status Codes
- Metadata APIs
- Modules
- Fields
- Layouts
- Related Lists
- Profiles
- Custom View
- Roles
- Territories
- GETTerritories
- POSTTerritories
- PUTTerritories
- DELETETerritories
- POSTTransfer and Delete Territories
- GETChild Territories of a Territory
- POSTAssign Territories to Records
- GETTerritories Assigned
- POSTRemove Territories of Records
- GETAssociated User Count
- PUTAssociate Users with Territory
- DELETEDisassociate Users from Territory
- GETRetrieve User details Associated with a Territory
- Scoring Rules
- Variables
- Map Dependency
- User Groups
- Tags
- Pipeline
- Wizards
- Assignment Rules
- Templates
- User's Unavailability
- Portals
- Fiscal Year
- Business Hours
- Holidays
- Record Locking Configuration
- Shift Hours
- Entity APIs
- Organization
- Users
- Records
- Related Records
- Records APIs using External ID
- Meeting Cancel
- Subforms
- Linking Modules
- Contact Roles
- Photos and Attachments
- Mass Update
- Mass Delete
- Currencies
- Files
- Share
- Fields' Attachments
- Change Owner
- Mass Change Owner
- Blueprint
- Emails
- Notes
- Related Records Using External ID
- Composite API
- Bulk APIs
- Notification APIs
- Query API
Update Profile Permissions
Purpose
To update the permissions of a profile.
Endpoints
Request Details
Request URL
{api-domain}/crm/{version}/settings/profiles/{profile-id}
Where, profile-id is the unique ID of the existing profile you want to update the permission for. Use the Get Profiles API to get this ID.
Header
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Scope
scope=ZohoCRM.settings.profiles.ALL
(or)
scope=ZohoCRM.settings.profiles.UPDATE
Sample Request
Copiedcurl "https://www.zohoapis.com/crm/v5/settings/profiles/3652397000009592005"
-X PUT
-d "@update.json"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
Input JSON
- namestring, mandatory
The name of the profile.
- permissions_detailsJSON Array, mandatory
id-string, mandatory - The ID of the permission you want to enable or disable for this profile. The permission_details key in the response of Get Profiles API gives you the ID of every permission available for the profile.
enabled-boolean, mandatory - The boolean key to enable or disable a permission for this profile.
Sample Input
Copied{
"profiles": [
{
"name": "test",
"permissions_details": [
{
"id": "3652397000000026530",
"enabled": true
}
]
}
]
}
Possible Errors
- INVALID_DATAHTTP 400
The profile ID is incorrect.
Resolution: Use the Get Profiles API to get this ID.
Sample Response
Copied{
"profiles": [
{
"code": "SUCCESS",
"details": {
"id": "3652397000009592005"
},
"message": "profile updated successfully",
"status": "success"
}
]
}
© 2025, Zoho Corporation Pvt. Ltd. All Rights Reserved.