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!
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
Extension 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 becomesExtension pointers: Handle cases with personalized solutions using custom actions
In our last post, we detailed the steps involved in creating a custom action and the workflow from the developer and end user's side. Now let's look at a working example of how we can create a custom action and implement it in a Zoho CRM account to makeExtension pointers - Simple yet significant pointers #13: On change of field value for CRM variables
CRM variables provide global access to a variable across an entire extension. They also help in the storage of user-specific data provided by the user at the time of installation, which can later be fetched to perform data functionalities. Additionally,Extension pointers: Extend end-user benefits and allow personalization by implementing extensions with custom actions
From our earlier post on custom actions, we know that we can create templated actions, share them with end users, and allow them to reuse those actions to achieve personalized outcomes. In this post, we'll look at how custom actions make it easy for usersExtension pointers - Simple yet significant pointers #12: Functions for Zoho CRM extensions
Functions are essential in achieving logical functionality for an extension. You can easily code your functions in Deluge using drag-and-drop tools to meet your requirements. How to create functions for Zoho CRM extensions in Sigma Go to Sigma and select
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 WorkDrive 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セミナー