- 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
Create a Profile
Purpose
To create a profile in your Zoho CRM organization.
Endpoints
- POST /settings/profiles/{clone_profile_ID}/actions/clone
Request Details
Request URL
{api-domain}/crm/{version}/settings/profiles/{clone_profile_ID}/actions/clone
Where, clone-profile-id is the unique ID of the existing profile you want to clone. Use the Get Profiles API to get this ID.
Header
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Scope
ZohoCRM.settings.profiles.ALL
(or)
ZohoCRM.settings.profiles.CREATE
Sample Request
Copiedcurl "https://www.zohoapis.com/crm/v8/settings/profiles/3652397000000026011/actions/clone"
-X POST
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-d "@inputData.json"Input JSON
- namestring, mandatory
The name of the new profile. Accepts up to 50 characters.
- descriptionstring, optional
A description of the profile. Accepts up to 250 characters.
Note
- You can create one profile in a single API call.
- By default, when you clone a profile (the parent profile specified in the Request URL), the newly created profile inherits the same access permissions in your Zoho CRM. However, to modify the access permissions for the new profile, you can use the Update Profile Permissions API.
Sample Input
Copied{
"profiles": [
{
"name": "Sales Manager",
"description": "Manages Sales for the TX region"
}
]
}Possible Errors
- NO_PERMISSIONHTTP 403
You do not have permission to create a profile
Resolution: Contact your administrator to upgrade your permission. - DUPLICATE_DATAHTTP 404
The profile you are trying to create already exists
Resolution: The name of the profile is unique. Create a profile with a different name. - PROFILE_LIMIT_EXCEEDEDHTTP 404
You can have a maximum of 25 profiles for your org
Resolution: Delete unwanted profiles to create new ones within the maximum limit.
Sample Response
Copied{
"profiles": [
{
"code": "SUCCESS",
"details": {
"id": "3652397000009590009"
},
"message": "profile created successfully",
"status": "success"
}
]
}© 2025, Zoho Corporation Pvt. Ltd. All Rights Reserved.