- 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
Delete Records Using External ID
Purpose
To delete the records in a module using external IDs.
Request Details
Request URL
https://www.zohoapis.com/crm/{version}/{module_api_name}
Header
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
X-EXTERNAL: {module_API_name}.{external_field_API_name}
Scope
scope=ZohoCRM.modules.all
(or)
scope=ZohoCRM.modules.{module_name}.{operation_type}
Possible module names
leads, deals, contacts, accounts, products, campaigns, services, appointments and pricebooks
Possible operation types
ALL - Full access to the records
WRITE - Edit records in the module
DELETE - Delete records from the module
Deleting a record using an external ID
In this example, we will delete the record in the Contacts module with the external value extcontact3 in the external field "External_Contact_ID".
Sample Request
Copiedcurl "https://www.zohoapis.com/crm/v8/Contacts/extcontact3"
-X DELETE
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-H "X-EXTERNAL: Contacts.External_Contact_ID"
Sample Response
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"External_Contact_ID": "extcontact4",
"id": "111111000000110002"
},
"message": "record deleted",
"status": "success"
}
]
}
Deleting the records using the "ids" parameter
In this example, we have used the "ids" parameter with values as the values of the external field in the Contacts module.
Sample Request
Copiedcurl "https://www.zohoapis.com/crm/v8/Contacts?ids=extcontact3,extcontact4"
-X DELETE
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-H "X-EXTERNAL: Contacts.External_Contact_ID"
Possible Errors
- INVALID_DATAHTTP 400
The value of the external field is invalid.
Resolution: Specify the correct external ID of the record.
Sample Response
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"External_Contact_ID": "extcontact3",
"id": "111111000000101047"
},
"message": "record deleted",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"External_Contact_ID": "extcontact4",
"id": "111111000000101018"
},
"message": "record deleted",
"status": "success"
}
]
}
Show full
Show less
© 2025, Zoho Corporation Pvt. Ltd. All Rights Reserved.