Delete Territories
Purpose
To delete territories from your organization.
Request Details
Request URL
{api-domain}/crm/{version}/settings/territories
{api-domain}/crm/{version}/settings/territories/{territoryid}
Header
Authorization: Zoho-oauthtoken 100xx.92d4xxxxxxxxxxxxx15f52
Scope
scope=ZohoCRM.settings.territories.{operation_type}
Possible operation types
ALL - Full access to territories
DELETE - Delete territories
Parameters
- idsstring, mandatory
Specify the unique ID of the territories that you want to delete.
Possible values: Territory IDs separated by commas or a single territory ID.
For example: 431581000000272796, 431581000000272786. Use the Get Territories API to get the ID of the territory. - delete_previous_forecastsBoolean, mandatory
Delete previous forecasts made by the territory
Maximum number of territories that can be deleted in one API call is 10
Sample Request
Copied
Possible Errors
- INVALID_DATAHTTP 400
The territory given is invalid
Resolution: Give valid territory ID - NOT_ALLOWEDHTTP 400
This territory has a child territory associated with it. It can't be deleted directly as transfer of child territory is required.
Resolution: Use transfer and delete api to delete the parent territory- The territory you are trying to delete is the Org Territory
- PERMISSION_DENIEDHTTP 401
You don't have a permission to delete the Territory
Resolution:The user does not have permission to delete the territory. Contact your system administrator.
Sample Response
Copied