Updates to Assign and Remove Territories APIs
Hello everyone!
This post is to inform you of the changes to the Assign and Remove territories APIs from V2 to V6.
Currently, from versions 2 to 6, the assign and remove territories APIs give a success response and assign or remove territories of the record.
In the new flow, these APIs will schedule a job. You can use the Job Status API to check the status.
Owing to this, there will be a change in the response from V2 to V6.
Read on for more details.
Affected APIs
Affected versions - V2 to V6
Response change
API URL Current response Updated response in V2 to V6 Response in V7 /crm/{version_2_to_6}/
{module_api_name}/{record_id}
/actions/assign_territories Status Code : 200{"data": [{"code": "SUCCESS","details": {"id": "2xx5" //record id}"message": "the territories data updated successfully",
"status": "success"}]} Status Code : 200{"data": [{"code": "SUCCESS","details": {"id": "2xxx45", //record id"job_id": "4xxxx2"}"message": "Territory assignment process scheduled successfully","status": "success"}]} Status Code : 202{"data": [{"code": "SCHEDULED","details": {"id": "2xxx5", //record id"job_id": "4xxxx2"}"message": "Territory assignment process scheduled successfully","status": "success"}]} /crm/{version_2_to_6}/
{module_api_name}/{record_id}
/actions/remove_territories Status Code : 200{"data": [{"code": "SUCCESS","details": {"id": "2xx5" //record id}"message": "the territories data updated successfully",
"status": "success"}]} Status Code : 200{"data": [{"code": "SUCCESS","details": {"id": "2xxx45", //record id"job_id": "4xxxx2"}"message": "Territory removal process scheduled successfully","status": "success"}]} Status Code : 202{"data": [{"code": "SCHEDULED","details": {"id": "2xxx5", //record id"job_id": "4xxxx2"}"message": "Territory removal process scheduled successfully","status": "success"}]}
API URL
Current response
Updated response in V2 to V6
Response in V7
/crm/{version_2_to_6}/
{module_api_name}/{record_id}
/actions/assign_territories
{module_api_name}/{record_id}
/actions/assign_territories
Status Code : 200
{
"data": [
{
"code": "SUCCESS",
"details": {
"id": "2xx5" //record id
}
"message": "the territories data updated successfully",
"status": "success"
}
]
}
Status Code : 200
{
"data": [
{
"code": "SUCCESS",
"details": {
"id": "2xxx45", //record id
"job_id": "4xxxx2"
}
"message": "Territory assignment process scheduled successfully",
"status": "success"
}
]
}
Status Code : 202
{
"data": [
{
"code": "SCHEDULED",
"details": {
"id": "2xxx5", //record id
"job_id": "4xxxx2"
}
"message": "Territory assignment process scheduled successfully",
"status": "success"
}
]
}
/crm/{version_2_to_6}/
{module_api_name}/{record_id}
/actions/remove_territories
{module_api_name}/{record_id}
/actions/remove_territories
Status Code : 200
{
"data": [
{
"code": "SUCCESS",
"details": {
"id": "2xx5" //record id
}
"message": "the territories data updated successfully",
"status": "success"
}
]
}
Status Code : 200
{
"data": [
{
"code": "SUCCESS",
"details": {
"id": "2xxx45", //record id
"job_id": "4xxxx2"
}
"message": "Territory removal process scheduled successfully",
"status": "success"
}
]
}
Status Code : 202
{
"data": [
{
"code": "SCHEDULED",
"details": {
"id": "2xxx5", //record id
"job_id": "4xxxx2"
}
"message": "Territory removal process scheduled successfully",
"status": "success"
}
]
}
This update will be rolled out in phases from May 1, 2024.
We will update the relevant API documents with the release.
Let us know if you have any questions in the comment section, or write to us at support@zohocrm.com.
Thanks!
Access your files securely from anywhere
Zoho Developer Community
New to Zoho LandingPage?
Zoho LandingPage Resources
New to Zoho Survey?
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Bigin?
Topic Participants
Shylaja S
Sticky Posts
Kaizen#162 : Add Tags and Open Pre-filled Email Drafts via Client Scripts
Hello everyone! Welcome to another informative Kaizen post. In this post, let us see how to accomplish the following using Client Script. 1. How to auto-tag a record based on field update? 2. How to Open a pre-filled email draft This post will provideClient Script | Update - Introducing Commands in Client Script!
Have you ever wished you could trigger Client Script from contexts other than just the supported pages and events? Have you ever wanted to leverage the advantage of Client Script at your finger tip? Discover the power of Client Script - Commands! CommandsExtension Pointers - JS SDK series #4: Managing data from a widget using ZOHO.CRM.HTTP
Handling and managing the data between two applications is a major factor for an efficient business. There are a variety of ways to handle data between Zoho CRM and other third-party applications. You can use deluge CRM tasks, create connectors, use APIKaizen #152 - Client Script Support for the new Canvas Record Forms
Hello everyone! Have you ever wanted to trigger actions on click of a canvas button, icon, or text mandatory forms in Create/Edit and Clone Pages? Have you ever wanted to control how elements behave on the new Canvas Record Forms? This can be achievedExtension pointers for integrating Zoho CRM with Zoho products #8: Upload and manage Zoho Workdrive folders and files from within Zoho CRM
Keeping records on your customers and business prospects is essential for tracking data, conducting follow-ups, and running a business smoothly. When you use two separate applications, and store relevant data in each, checking and tracking data becomes
New to Zoho TeamInbox?
Zoho TeamInbox Resources
Zoho DataPrep Resources
Zoho CRM Plus Resources
Zoho Books Resources
Zoho Subscriptions Resources
Zoho Projects Resources
Zoho Sprints Resources
Qntrl Resources
Zoho Creator Resources
Zoho Campaigns Resources
Zoho CRM Resources
Design. Discuss. Deliver.
Zoho Show Resources
Get Started. Write Away!
Writer is a powerful online word processor, designed for collaborative work.
Zoho CRM コンテンツ
-
オンラインヘルプ
-
Webセミナー
-
機能活用動画
-
よくある質問
-
Ebook
-
-
Zoho Campaigns
- Zoho サービスのWebセミナー