updateRelatedRecords Method

updateRelatedRecords Method

Purpose

You can use the updateRelatedRecords method to update records related to another record.

Modules Supported

Module Related Module
Campaigns

Leads
Contacts
Products

Leads
Accounts
Contacts
Potentials
Price Books

Note:

  • It is also possible to update a Campaign or Product keeping any of the Related Module as the Parent Module.

Request URL

To update the member status of a Contact related to a Campaign

XML Format:

https://crm.zoho.com/crm/private/xml/Campaigns/updateRelatedRecords?authtoken=Auth Token&scope=crmapi
&relatedModule=Contacts&xmlData=<Contacts><row no="1"><FL val="CONTACTID">9999999999</FL><FL val="member_status">Sent</FL></row></Contacts>&id=99999999999

JSON Format:

https://crm.zoho.com/crm/private/json/Campaigns/updateRelatedRecords?authtoken=Auth Token&scope=crmapi&relatedModule=Contacts&xmlData=<Contacts><row no="1"><FL val="CONTACTID">9999999999</FL><FL val="member_status">Sent</FL></row></Contacts>&id=99999999999

Request Parameters

Parameter Data Type Description
authtoken* String Encrypted alphanumeric string to authenticate your Zoho credentials.
scope* String Specify the value as crmapi.
relatedModule* String The module to which a record is related.

For example: If a lead related to a campaign needs to be updated, the value for this parameter will be Leads.
id* Integer The ID of the record to be updated.
xmlData* XML The XML values to be passed.

* - Mandatory parameter

Note:

  • Refer the Release Notes page to learn more about enhancements made in the API implementation.

Additional Notes

  • You can update a maximum of 100 records.
  • While retrieving data from your Zoho CRM account, role-based security (Roles, Profiles, Field-level security and Data sharing rules) is applied. For role-based security settings, see Security Administration.

Examples

To update the list price of a Product related to a Price Book

https://crm.zoho.com/crm/private/xml/PriceBooks/updateRelatedRecords?authtoken=Your Authenticaton Token&scope=crmapi&id=Price Book ID&relatedModule=Products&xmlData=<Products><row no="1"><FL val="PRODUCTID">508020000000061987</FL><FL val="list_price">100.00</FL></row></Products>

Response Format

<response uri="/crm/private/xml/PriceBooks/updateRelatedRecords">
<result>
<status>
<code>200</code>
</status>
<success>
<code>4800</code>
</success>
<updated-ids>[508020000000061987]</updated-ids>
</result>
</response>

    • Related Articles

    • updateRelatedRecords Method - Comparison

      Purpose To update records related to another record. Request URL Version 1.0: https://crm.zoho.com/crm/private/xml/Campaigns/updateRelatedRecords?authtoken=AuthToken&scope=crmapi&relatedModule=Contacts&xmlData=<Contacts><row ...

    • deleteRecords Method

      Table of Contents Purpose Request URL Request Parameters Example Purpose You can use this method to delete the selected record (you must specify unique ID of the record) and move to the recycle bin. Note: This method is availablefor all modules. ...

    • downloadPhoto Method

       Purpose You can use this method to download the photos of Leads or Contacts.  Request URL XML Format: For Leads: https://crm.zoho.com/crm/private/xml/Leads/downloadPhoto?authtoken=Auth Token&scope=crmapi&id=RecordID For Contacts: ...

    • searchRecords Method

       Purpose You can use the searchRecords method to get the list of records that meet your search criteria.  Request URL XML Format: https://crm.zoho.com/crm/private/xml/Leads/searchRecords?authtoken=Auth Token&scope=crmapi&criteria=(((Last ...

    • deleteFile Method

      Purpose You can use this method to delete files attached to records. Request URL XML Format: https://crm.zoho.com/crm/private/xml/Leads/deleteFile?authtoken=Auth Token&scope=crmapi&id=Attachment Id JSON Format: ...