Zoho Books icon

Zoho Books

Interact with Zoho Books API (OAuth2)
Join our community

Actions17

Overview

This node interacts with the Zoho Books API to update contact information within a Zoho Books organization. Specifically, the "Update Contact" operation allows users to modify details of an existing contact by specifying its unique Contact ID and providing new values for fields such as name, email, and phone number.

Common scenarios where this node is beneficial include:

  • Keeping customer or vendor contact information up-to-date automatically from other systems.
  • Synchronizing contact details after changes in CRM or support platforms.
  • Automating bulk updates of contacts based on external data feeds.

For example, if a customer's phone number changes, this node can be used in an automation workflow to update that contact's record in Zoho Books without manual intervention.

Properties

Name Meaning
Contact ID The unique identifier of the contact to update. Required to specify which contact to modify.
Contact Name The new or updated name of the contact.
Email The new or updated email address of the contact.
Phone The new or updated phone number of the contact.

Output

The node outputs an array of JSON objects representing the updated contact(s). Each output item contains a json field with the following structure:

  • For a successful update, the json object includes the updated contact details as returned by the Zoho Books API under the key contact.
  • If multiple contacts are updated (though typically one per execution), each will be an individual item in the output array.
  • In case of errors (if "Continue On Fail" is enabled), the output item will contain an error field describing the issue.

No binary data is produced by this node.

Dependencies

  • Requires valid Zoho Books OAuth2 credentials configured in n8n, including:
    • An OAuth2 access token for Zoho Books API authentication.
    • The Zoho Books organization ID must be set in the credentials.
  • Internet access to call the Zoho Books API endpoints.
  • The node uses the Zoho Books API base URL dynamically based on the domain specified in credentials.

Troubleshooting

  • Missing Organization ID: The node throws an error if the Zoho Books organization ID is not set in the credentials. Ensure this is configured correctly.
  • Contact ID Required: For the update operation, the Contact ID must be provided; otherwise, an error is thrown.
  • Invalid JSON in Additional Data: If additional JSON data is provided (not applicable here but relevant for invoices/payments), it must be valid JSON or the node will error.
  • API Errors: Errors returned by Zoho Books API include error codes and messages. These are surfaced in the node’s error output or thrown exceptions.
  • Network Issues: Connectivity problems or invalid credentials will cause request failures.
  • To resolve errors, verify credentials, ensure required parameters are set, and check the validity of input data.

Links and References

Discussion