Zoho BooksInstall

Overview

This node integrates with the Zoho Books API to perform operations on various resources, including Contacts. Specifically, for the Contact resource and the Search operation, it allows users to search for contacts by full or partial customer name. This is useful in scenarios where you want to find existing customers in your Zoho Books account based on their names, such as when syncing contact data, validating customer existence before creating invoices, or automating customer-related workflows.

For example, you might use this node to:

• Search for a customer by name before creating an invoice to ensure the customer exists.
• Retrieve contact details dynamically during an automation that processes customer orders.
• Filter contacts matching a partial name input from a form or another system.

Properties

The node requires the "Search Name" property to specify the customer name (or part of it) to look up in Zoho Books contacts.

Output

The output is a JSON array of contact objects matching the search criteria. Each item in the output corresponds to one contact found in Zoho Books. The structure of each contact object follows the Zoho Books API's contact representation, typically including fields like contact ID, name, email, phone, billing and shipping addresses, and other relevant contact details.

No binary data output is produced by this operation.

Dependencies

• Requires an active connection to Zoho Books via an OAuth2 API credential configured in n8n.
• The node depends on the Zoho Books API being accessible and the OAuth token having sufficient permissions to read contact data.
• No additional external dependencies beyond the Zoho Books API and n8n's OAuth2 credential setup.

Troubleshooting

• Common Issues:

  • Invalid or expired OAuth2 credentials will cause authentication errors.
  • Providing an empty or invalid "Search Name" may return no results or an error.
  • Network connectivity issues can prevent API calls from succeeding.

• Error Messages:

  • "Unsupported resource: contact": This would indicate a misconfiguration or internal error; however, the Contact resource is supported.
  • API errors returned from Zoho Books (e.g., rate limits, permission denied) will be surfaced as node errors.

• Resolutions:

  • Ensure OAuth2 credentials are valid and refreshed.
  • Provide a meaningful "Search Name" string.
  • Check network connectivity and API status.
  • Use the node's "Continue On Fail" option to handle errors gracefully in workflows.

Links and References

• Zoho Books API Documentation - Contacts
• n8n OAuth2 Credential Setup
• n8n Expressions and Parameters