Mass Update API
The mass update feature allows you to update the values of specific fields for multiple records in territories or custom views in a module. This API is useful when you want to update the same field for all records in a module, territory, or a custom view.
In this API, the input contains the API names of the fields whose values you want to update, and the record ids, cvids(custom view IDs), or territory_id.
You can update up to 50,000 (fifty thousand) records using this API.
Mass update of records happens in two ways:
Scheduler type: When you specify custom view ID and territory ID, a job is scheduled in the background and the system returns a "job_id". Use this job_id in the GET request to get the result.
Non-scheduler type: When you specify the record IDs, system updates the records instantly. You can update a maximum of 500 records in a single API call in this type of mass update.
Mass Update Records
Request URL
https://www.zohoapis.com/crm/v2/{module_api_name}/actions/mass_update
module_api_name - The API name of the module
Supported modules |
---|
Leads, Accounts, Contacts, Deals, Campaigns, Activities, Solutions, Products, Vendors, Price Books, Quotes, Sales Orders, Purchase Orders, Invoices, and Custom |
Request Method
POST
Scope
scope=ZohoCRM.mass_update.{module_name}.UPDATE
Possible module names |
---|
leads, accounts, contacts, deals, campaigns, activities, solutions, products, vendors, pricebooks, quotes, salesorders, purchaseorders, invoices, and custom |
Request JSON
Attribute | Data Type | Mandatory | Description |
---|---|---|---|
cvid | String | Yes, when custom view fields or territory fields are updated | The custom view ID whose records you want to mass update |
over_write | Boolean | No | Used when updating a multi-select picklist field. The value true replaces all the multi-select picklist values with the value specified for mass update. The value false adds the specified value to the picklist. Default value is false. |
territory | JSON Object | Yes, when territory fields are updated | id - The territory ID to update the records in that territory include_child - Boolean field to indicate whether you want to mass update the child territory records as well. Default value is false. |
ids | JSON Array | Yes, when records are updated by IDs | Specify the IDs of the records you want to mass update. |
Response Structure
Attribute | Data Type | Description |
---|---|---|
code | String | Indicates the status of mass update |
details | JSON Object | Specifies the "job_id" (for scheduler type), modified time and the name and ID of the user who modified the record (for non-scheduler type). |
created_time | ISO8601 | Specifies the time period when the record was created. |
id | String | Specifies the unique ID (record ID) of the record that was updated. |
Created_By | JSON Object | Specifies the name and ID of the user that created the record. |
message | String | Specifies if the record is updated or the reason for error, if any. |
status | String | Specifies the status of the record as updated, error etc. |
Possible Errors
HTTP Status | Error Code | Message | Reason |
---|---|---|---|
200 | INVALID_DATA | No field found | No field is specified in the input |
200 | INVALID_DATA | Max field limit exceeded | Number of fields to be mass updated has exceeded the allowed limit for that module |
200 | INVALID_DATA | This field cannot be updated in the Mass Update | The specified field is not found in the module or it is not allowed for mass update |
200 | INVALID_DATA | Field cannot be updated as it is associated with a layout rule | The specified field is used as primary in a layout rule |
200 | INVALID_DATA | Field cannot be updated as it is associated with a validation rule | The specified field is used as primary in a validation rule |
200 | INVALID_DATA | Field is not visible | The specified field is made invisible/inaccessible to the user |
200 | INVALID_DATA | The id given seems to be invalid | The record ID, cvid, or territory ID specified is invalid |
200 | CANNOT_PROCESS | The record is in stop processing | The specified record is in the stop processing state |
200 | RECORD_IN_BLUEPRINT | The record is in blue print | The specified record is in blueprint and user tries to update a blueprint picklist value |
200 | MANDATORY_NOT_FOUND | required field not found | No cvid or record ID is specified in the input |
200 | CANNOT_PERFORM_ACTION | no permission to perform an action on this record | User does not have permission to perform any action on the record |
200 | ALREADY_SCHEDULED | Already a Mass Action scheduler is running for the given cvid | The records in the custom view specified are already scheduled for mass update |
200 | LIMIT_EXCEEDED | Record count exceeded | Number of records that can be mass updated has exceeded the maximum allowed limit of 50000 |
200 | NOT_APPROVED | record not approved | The record with the specified ID is not approved |
400 | NO_RECORDS_FOUND | no record found to update | There are no records in the custom view specified |
403 | NO_PERMISSION | permission denied | User does not have permission to mass update records |
403 | NO_PERMISSION | Field Edit Permission not given | User does not have permission to edit the field |
403 | NO_PERMISSION | Customview not accessible | Custom view is not accessible to the user or the module |
It is mandatory to specify either custom view ID or record IDs in the input.
It is mandatory to specify the custom view ID when you want to mass update records in a territory.
You cannot mass update Email, lookup fields, layout fields, multi line fields, and line items.
You can mass update up to three fields in the Deals module and only one field in all other modules in a single API call.
You can mass update a maximum of 500 records in a single API call when you use the non-scheduler type mass update (i.e with record IDs).
You can mass update a maximum of 50,000 (fifty thousand) records in a single API call when you use the scheduler type mass update (i.e by specifying the cvid and territory ID).
While mass updating records based on their IDs, if some of the records have invalid data, only those records will not be processed.
Use Territories API to get the territory ID.
For the non-scheduler type mass update, automation rules such as approvals, blueprints, and workflows are triggered automatically.
For the scheduler type mass update, automation rules are triggered automatically when the record count is less than 1000.
When the record count is greater than 1000, automation rules do not get triggered.
Sample Request
Copiedcurl "https://www.zohoapis.com/crm/v2/Accounts/actions/mass_update"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-d "@input.json"
-X POST
CopiedList<Long> listRecord = new ArrayList<Long>();
listRecord.add(3719520000000331001L);
listRecord.add(3719520000000329001L);
listRecord.add(3719520000000326001L)
ZCRMModule moduleIns = ZCRMModule.getInstance("Leads"); //To get the Module instance
BulkAPIResponse response = moduleIns.massUpdateRecords(listRecord, "Lead_Status", "Contacted"); //To call the update record method
Copied$zcrmModuleIns = ZCRMModule::getInstance("Contacts");
$entityIds=array(554023000000497021,554023000000497007);//array of entity ids
responseIn=$moduleIns->massUpdateRecords($entityIds,"Lead_Source","Chat"); //to update the field api name with corresponding field value for the entities
foreach($responseIn->getEntityResponses() as $responseIns){
echo "HTTP Status Code:".$responseIn->getHttpStatusCode(); //To get http response code
echo "Status:".$responseIns->getStatus(); //To get response status
echo "Message:".$responseIns->getMessage(); //To get response message
echo "Code:".$responseIns->getCode(); //To get status code
echo "Details:".json_encode($responseIns->getDetails());
}
Copieddef mass_update_records(self):
try:
module_ins = zcrmsdk.ZCRMModule.get_instance('Invoices') # Module API Name
entityid_list = [554023000000527034, 554023000000527033] # record Id
bulk_resp = module_ins.mass_update_records(entityid_list, 'Status', 'Created') #To call the update record method
print(bulk_resp.status_code)
entity_responses = bulk_resp.bulk_entity_response
for entity_response in entity_responses:
print(entity_response.details)
print(entity_response.status)
print(entity_response.message)
print(entity_response.code)
print(entity_response.data.entity_id)
print(entity_response.data.created_by.id)
print(entity_response.data.created_time)
print(entity_response.data.modified_by.id)
print("\n\n")
except zcrmsdk.ZCRMException as ex:
print(ex.status_code)
print(ex.error_message)
print(ex.error_code)
print(ex.error_details)
print(ex.error_content)
Copiedpublic void MassUpdateRecords()
{
List<long> listRecord = new List<long>() { 554023000000497007, 554023000000497021, 554023000000497035 };
ZCRMModule moduleIns = ZCRMModule.GetInstance("Leads"); //To get the Module instance
BulkAPIResponse<ZCRMRecord> responseIns = moduleIns.MassUpdateRecords(listRecord, "Lead_Status", "Contacted"); //To call the update record method
Console.WriteLine("HTTP Status Code:" + responseIns.HttpStatusCode); //To get update record http response code
foreach (EntityResponse response in responseIns.BulkEntitiesResponse)
{
Console.WriteLine("Status:" + response.Status); //To get Update record response status
Console.WriteLine("Message:" + response.Message); //To get Update record response message
Console.WriteLine("Details:" + response.ResponseJSON); //To get Update record response details
/*ZCRMRecord record = (ZCRMRecord)response.Data;
Console.WriteLine(record.EntityId); //To get inserted record id
Console.WriteLine(record.Leads);*/
}
}
Sample Response
Copied{
"data": [
{
"Industry": "Education"//field to be updated
}
],
"cvid": "554023000000091515", //custom view ID to mass update records in that custom view
"territory": {
"id": "554023000000430409",//ID of the territory to mass update records in that territory
"include_child": true //include child territory records for mass updation
}
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"job_id": "554023000000506003"
},
"message": "mass update scheduled successfully",
"status": "success"
}
]
}
Copiedcurl "https://www.zohoapis.com/crm/v2/Deals/actions/mass_update"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-d "@input.json"
-X POST
Copied{
"data": [
{
"Lead_Source": "Advertisement",
"Type": "Existing Business",
"Languages_Known": [
"English",
"Spanish"
]
}
],
"over_write": true,
"ids": [
"554023000000497007",
"554023000000497021",
"554023000000497035"
]
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:11:52+05:30",
"id": "554023000000497007",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:10+05:30",
"id": "554023000000497021",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:42+05:30",
"id": "554023000000497035",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
}
]
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
},
"Created_Time": "2019-04-24T18:11:52+05:30",
"id": "3719520000000331001",
"Created_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
},
"Created_Time": "2019-04-24T18:12:10+05:30",
"id": "3719520000000329001",
"Created_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
},
"Created_Time": "2019-04-24T18:12:42+05:30",
"id": "3719520000000326001",
"Created_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
}
},
"message": "record updated",
"status": "success"
}
]
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:11:52+05:30",
"id": "554023000000497007",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:10+05:30",
"id": "554023000000497021",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
}
]
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:11:52+05:30",
"id": "554023000000527034",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:10+05:30",
"id": "554023000000527033",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
}
]
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:11:52+05:30",
"id": "554023000000497007",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:10+05:30",
"id": "554023000000497021",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:42+05:30",
"id": "554023000000497035",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
}
]
}
Sample Response
Copied{
"data": [
{
"Industry": "Education"//field to be updated
}
],
"cvid": "554023000000091515", //custom view ID to mass update records in that custom view
"territory": {
"id": "554023000000430409",//ID of the territory to mass update records in that territory
"include_child": true //include child territory records for mass updation
}
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"job_id": "554023000000506003"
},
"message": "mass update scheduled successfully",
"status": "success"
}
]
}
Copiedcurl "https://www.zohoapis.com/crm/v2/Deals/actions/mass_update"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-d "@input.json"
-X POST
Copied{
"data": [
{
"Lead_Source": "Advertisement",
"Type": "Existing Business",
"Languages_Known": [
"English",
"Spanish"
]
}
],
"over_write": true,
"ids": [
"554023000000497007",
"554023000000497021",
"554023000000497035"
]
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:11:52+05:30",
"id": "554023000000497007",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:10+05:30",
"id": "554023000000497021",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:42+05:30",
"id": "554023000000497035",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
}
]
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
},
"Created_Time": "2019-04-24T18:11:52+05:30",
"id": "3719520000000331001",
"Created_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
},
"Created_Time": "2019-04-24T18:12:10+05:30",
"id": "3719520000000329001",
"Created_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
},
"Created_Time": "2019-04-24T18:12:42+05:30",
"id": "3719520000000326001",
"Created_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
}
},
"message": "record updated",
"status": "success"
}
]
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:11:52+05:30",
"id": "554023000000497007",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:10+05:30",
"id": "554023000000497021",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
}
]
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:11:52+05:30",
"id": "554023000000527034",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:10+05:30",
"id": "554023000000527033",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
}
]
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:11:52+05:30",
"id": "554023000000497007",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:10+05:30",
"id": "554023000000497021",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:42+05:30",
"id": "554023000000497035",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
}
]
}
Sample Response
Copied{
"data": [
{
"Industry": "Education"//field to be updated
}
],
"cvid": "554023000000091515", //custom view ID to mass update records in that custom view
"territory": {
"id": "554023000000430409",//ID of the territory to mass update records in that territory
"include_child": true //include child territory records for mass updation
}
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"job_id": "554023000000506003"
},
"message": "mass update scheduled successfully",
"status": "success"
}
]
}
Copiedcurl "https://www.zohoapis.com/crm/v2/Deals/actions/mass_update"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-d "@input.json"
-X POST
Copied{
"data": [
{
"Lead_Source": "Advertisement",
"Type": "Existing Business",
"Languages_Known": [
"English",
"Spanish"
]
}
],
"over_write": true,
"ids": [
"554023000000497007",
"554023000000497021",
"554023000000497035"
]
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:11:52+05:30",
"id": "554023000000497007",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:10+05:30",
"id": "554023000000497021",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:42+05:30",
"id": "554023000000497035",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
}
]
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
},
"Created_Time": "2019-04-24T18:11:52+05:30",
"id": "3719520000000331001",
"Created_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
},
"Created_Time": "2019-04-24T18:12:10+05:30",
"id": "3719520000000329001",
"Created_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
},
"Created_Time": "2019-04-24T18:12:42+05:30",
"id": "3719520000000326001",
"Created_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
}
},
"message": "record updated",
"status": "success"
}
]
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:11:52+05:30",
"id": "554023000000497007",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:10+05:30",
"id": "554023000000497021",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
}
]
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:11:52+05:30",
"id": "554023000000527034",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:10+05:30",
"id": "554023000000527033",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
}
]
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:11:52+05:30",
"id": "554023000000497007",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:10+05:30",
"id": "554023000000497021",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:42+05:30",
"id": "554023000000497035",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
}
]
}
Sample Response
Copied{
"data": [
{
"Industry": "Education"//field to be updated
}
],
"cvid": "554023000000091515", //custom view ID to mass update records in that custom view
"territory": {
"id": "554023000000430409",//ID of the territory to mass update records in that territory
"include_child": true //include child territory records for mass updation
}
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"job_id": "554023000000506003"
},
"message": "mass update scheduled successfully",
"status": "success"
}
]
}
Copiedcurl "https://www.zohoapis.com/crm/v2/Deals/actions/mass_update"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-d "@input.json"
-X POST
Copied{
"data": [
{
"Lead_Source": "Advertisement",
"Type": "Existing Business",
"Languages_Known": [
"English",
"Spanish"
]
}
],
"over_write": true,
"ids": [
"554023000000497007",
"554023000000497021",
"554023000000497035"
]
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:11:52+05:30",
"id": "554023000000497007",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:10+05:30",
"id": "554023000000497021",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:42+05:30",
"id": "554023000000497035",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
}
]
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
},
"Created_Time": "2019-04-24T18:11:52+05:30",
"id": "3719520000000331001",
"Created_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
},
"Created_Time": "2019-04-24T18:12:10+05:30",
"id": "3719520000000329001",
"Created_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
},
"Created_Time": "2019-04-24T18:12:42+05:30",
"id": "3719520000000326001",
"Created_By": {
"name": "Patricia Boyle",
"id": "3719520000000191015"
}
},
"message": "record updated",
"status": "success"
}
]
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:11:52+05:30",
"id": "554023000000497007",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:10+05:30",
"id": "554023000000497021",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
}
]
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:11:52+05:30",
"id": "554023000000527034",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:10+05:30",
"id": "554023000000527033",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
}
]
}
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:11:52+05:30",
"id": "554023000000497007",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:10+05:30",
"id": "554023000000497021",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"Modified_Time": "2019-04-25T18:59:19+05:30",
"Modified_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
},
"Created_Time": "2019-04-24T18:12:42+05:30",
"id": "554023000000497035",
"Created_By": {
"name": "Patricia Boyle",
"id": "554023000000235011"
}
},
"message": "record updated",
"status": "success"
}
]
}