Zoho CRM Custom icon

Zoho CRM Custom

Consume Zoho CRM API

Actions62

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 Create or Update (upsert) operation, this node will create a new product in Zoho CRM if it does not exist, or update an existing product if one with the same name is found. This is useful for keeping your product catalog synchronized between n8n workflows and Zoho CRM, automating inventory management, or integrating product data from other systems.

Practical examples:

  • Automatically add or update products in Zoho CRM when new items are added to your e-commerce platform.
  • Sync product information from an ERP system into Zoho CRM.
  • Batch update product details such as price, stock, or custom fields based on external triggers.

Properties

Name Type Meaning
Product Name string Name of the product. If a product with this name exists, it will be updated; otherwise, a new product will be created.
Additional Fields collection Optional additional properties to set on the product. See below for available sub-fields.

Additional Fields options:

Name Type Meaning
Commission Rate number Commission rate for the product (e.g., 12 for 12%).
Custom Fields fixedCollection Set values for custom product fields by field ID and value.
Description string Description of the product.
Manufacturer string Manufacturer of the product.
Product Active boolean Whether the product is active.
Product Category string Category of the product.
Quantity in Demand number Quantity in demand for the product.
Quantity in Stock number Quantity in stock for the product.
Taxable boolean Whether the product is taxable.
Unit Price number Unit price of the product.

Output

The output will be a JSON object containing the details of the created or updated product as returned by the Zoho CRM API. The structure typically includes:

{
  "id": "string",
  "Product_Name": "string",
  "Commission_Rate": number,
  "Description": "string",
  "Manufacturer": "string",
  "Product_Active": boolean,
  "Product_Category": "string",
  "Qty_in_Demand": number,
  "Qty_in_Stock": number,
  "Taxable": boolean,
  "Unit_Price": number,
  // ...any custom fields and additional metadata provided by Zoho CRM
}
  • All standard and custom fields set during creation/update will be present.
  • The id field uniquely identifies the product in Zoho CRM.

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 credential setup.

Troubleshooting

Common issues:

  • Missing Required Field: If "Product Name" is not provided, the node will throw an error.
  • Invalid Data Types: Providing non-numeric values for numeric fields (e.g., "Commission Rate") will result in errors.
  • API Authentication Errors: If credentials are missing or expired, authentication errors will occur.
  • Custom Field Issues: If a custom field ID is invalid or not present in Zoho CRM, the API may reject the request.

Error messages and resolutions:

  • "Required parameter 'Product Name' is missing": Ensure you provide a value for Product Name.
  • "Invalid value for field 'Commission Rate'": Check that the value is a number and within allowed range.
  • "Authentication failed": Reconnect or refresh your Zoho CRM credentials in n8n.
  • "Field not found": Double-check custom field IDs via Zoho CRM's field settings.

Links and References

Discussion