Zoho CRM Custom icon

Zoho CRM Custom

Consume Zoho CRM API

Overview

The Zoho CRM Custom node for n8n allows you to interact with the Zoho CRM API. Specifically, when using the Product resource and the Update operation, this node updates an existing product in your Zoho CRM account. You provide the Product ID and specify which fields to update (such as price, description, commission rate, custom fields, etc.).

Common scenarios:

  • Keeping product information in Zoho CRM up-to-date from another system.
  • Automating price or stock level adjustments based on external triggers.
  • Bulk updating product details as part of a workflow.

Example use cases:

  • When inventory changes in your ERP, automatically update the "Quantity in Stock" in Zoho CRM.
  • Update the "Commission Rate" for a set of products after a policy change.
  • Set custom field values for products based on data from another source.

Properties

Name Type Meaning
Product ID String (text) ID of the product to update. This is required to identify which product will be updated.
Update Fields Collection A group of fields to update on the product. Each sub-field below can be set individually.
└ Commission Rate Number Commission rate for the product (e.g., 12 for 12%).
└ Custom Fields FixedCollection One or more custom fields to set. Each requires a Field ID and a Value.
  └ Field ID Options The custom field to set a value for (selectable from available custom product fields).
  └ Value String The value to assign to the selected custom field.
└ Description String Product description.
└ Manufacturer String Manufacturer name.
└ Product Active Boolean Whether the product is active (true or false).
└ Product Category String Category of the product.
└ Quantity in Demand Number Quantity currently in demand.
└ Quantity in Stock Number Quantity currently in stock.
└ Taxable Boolean Whether the product is taxable.
└ Unit Price Number Price per unit of the product.

Output

The output is a JSON object representing the updated product's details as returned by the Zoho CRM API. The structure typically includes all standard and custom fields of the product, such as:

{
  "id": "1234567890",
  "Product_Name": "Sample Product",
  "Description": "Updated description",
  "Manufacturer": "Acme Corp",
  "Product_Active": true,
  "Product_Category": "Electronics",
  "Qty_in_Demand": 10,
  "Qty_in_Stock": 50,
  "Taxable": false,
  "Unit_Price": 99.99,
  "Commission_Rate": 12,
  "Custom_Field_1": "Value",
  ...
}
  • All fields present in Zoho CRM for the product may be included.
  • If the update fails, and "Continue On Fail" is enabled, the output will include an error property with the error message.

Dependencies

  • Zoho CRM Account: You must have a Zoho CRM account.
  • API Credentials: Requires OAuth2 credentials configured in n8n under the name zohoOAuth2Api.
  • n8n Configuration: No special environment variables are needed beyond the credential setup.

Troubleshooting

Common issues:

  • Missing or invalid Product ID: If the Product ID does not exist or is incorrect, the node will throw an error indicating the product was not found.
  • Empty Update Fields: If no fields are provided in "Update Fields", the node will throw an error to prevent empty updates.
  • Insufficient permissions: If the connected Zoho user lacks permission to update products, an authorization error will occur.
  • Invalid custom field IDs or values: Providing a non-existent custom field ID or an invalid value may result in an error from Zoho CRM.

Error messages and resolutions:

  • "No fields to update": Ensure at least one field is set in "Update Fields".
  • "Product not found": Double-check the Product ID.
  • "Invalid value for field X": Verify the value matches the expected type/format for that field.
  • "Unauthorized": Check your Zoho OAuth2 credentials and permissions.

Links and References

Discussion