Zoho CRM CustomInstall

Overview

The Zoho CRM Custom node for n8n allows you to update an existing Vendor record in Zoho CRM. This is useful when you need to programmatically modify vendor details, such as address, contact information, or custom fields, as part of your business automation workflows.

Common scenarios:

• Keeping vendor records up-to-date with changes from other systems.
• Automating corrections or enrichment of vendor data.
• Bulk updating vendor information based on external triggers.

Example:
If a vendor changes their address or contact details, this node can be used within an n8n workflow to automatically update the corresponding record in Zoho CRM.

---

Properties

Name	Type	Meaning
Vendor ID	String	The unique identifier of the vendor to update. Required.
Update Fields	Collection	A set of fields to update on the vendor record. You can add one or more of the following:
— Address	Collection	Structured address fields (Street, City, State, Country, Zip Code).
— Category	String	The category assigned to the vendor.
— Currency	String	The currency associated with the vendor.
— Custom Fields	Collection	One or more custom fields to update, each with a Field ID and Value.
— Description	String	A description for the vendor.
— Email	String	The vendor's email address.
— Phone	String	The vendor's phone number.
— Vendor Name	String	The name of the vendor.
— Website	String	The vendor's website URL.

---

Output

• The output is a JSON object containing the updated details of the vendor as returned by Zoho CRM.
• The structure will reflect the fields present in the vendor module, including any updated values.
• Example output:

{
  "id": "1234567890",
  "Vendor_Name": "Acme Supplies",
  "Email": "info@acme.com",
  "Phone": "+1-555-1234",
  "Address": {
    "Street": "123 Main St",
    "City": "Metropolis",
    "State": "NY",
    "Country": "USA",
    "Zip_Code": "10001"
  },
  "Category": "Preferred",
  "Currency": "USD",
  "Description": "Updated vendor info",
  "Website": "https://acme.com",
  "Custom_Field_1": "Value1"
  // ...other fields as defined in Zoho CRM
}

• If the update fails and "Continue On Fail" is enabled, the output will include an error field with the error message.

---

Dependencies

• External Service: Requires access to Zoho CRM.
• Authentication: Needs valid Zoho OAuth2 credentials configured in n8n (zohoOAuth2Api).
• n8n Configuration: No special environment variables required beyond standard credential setup.

---

Troubleshooting

Common Issues:

• Missing or Invalid Vendor ID:

  • Error: "No vendorId provided" or similar.
  • Solution: Ensure the "Vendor ID" property is set and corresponds to an existing vendor in Zoho CRM.

• Empty Update Fields:

  • Error: "Please enter at least one field to update"
  • Solution: Add at least one field under "Update Fields" to specify what should be changed.

• Invalid Custom Field ID:

  • Error: "Invalid custom field ID"
  • Solution: Make sure the custom field IDs match those defined in your Zoho CRM instance.

• API Authentication Errors:

  • Error: "Invalid authentication credentials" or token errors.
  • Solution: Check that your Zoho OAuth2 credentials are correctly configured and have not expired.

• Field Validation Errors:

  • Error: Messages indicating invalid data types or formats.
  • Solution: Verify that all field values conform to the expected format as per Zoho CRM requirements.

---

Links and References

• Zoho CRM API Documentation
• n8n Zoho CRM Node Docs
• How to get Zoho OAuth2 Credentials for n8n