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 configured with the Resource: Sales Order and Operation: Get, this node retrieves detailed information about a specific sales order from your Zoho CRM account using its unique ID.

Common scenarios:

  • Fetching details of a sales order for reporting or further automation.
  • Integrating sales order data into other business processes (e.g., invoicing, fulfillment).
  • Validating the existence or status of a sales order before taking subsequent actions.

Practical example:
You might use this node in a workflow that, upon receiving a new order notification, fetches the full sales order details from Zoho CRM and sends them to your ERP system or triggers an email confirmation.


Properties

Name Type Meaning
Sales Order ID String ID of the sales order to retrieve. This is required.

Output

The output will be a JSON object containing all available fields for the requested sales order as returned by the Zoho CRM API. The structure and field names depend on your Zoho CRM configuration but typically include details such as:

{
  "id": "1234567890",
  "Account_Name": { "name": "Acme Corp", "id": "987654321" },
  "Subject": "Order #1001",
  "Product_Details": [ ... ],
  "Status": "Delivered",
  ...
}
  • All standard and custom fields associated with the sales order will be present.
  • No binary data is produced by this operation.

Dependencies

  • Zoho CRM Account: You must have access to a Zoho CRM account.
  • API Credentials: The node requires valid Zoho OAuth2 credentials configured in n8n under the name zohoOAuth2Api.

Troubleshooting

Common issues:

  • Invalid Sales Order ID: If the provided Sales Order ID does not exist, the node will throw an error indicating the record was not found.
  • Authentication errors: If your Zoho OAuth2 credentials are missing or expired, you'll receive authentication/authorization errors.
  • API Limitations: Hitting Zoho's API rate limits may result in temporary failures.

Error messages and resolutions:

  • "Record not found": Double-check the Sales Order ID for typos or ensure it exists in Zoho CRM.
  • "Invalid OAuth token" or "Unauthorized": Refresh your Zoho OAuth2 credentials in n8n.
  • "Request failed with status code 429": Wait and retry after some time due to API rate limiting.

Links and References

Discussion