Actions17
Overview
This node interacts with the Zoho Books API to manage contacts, invoices, and customer payments. Specifically, for the Contact - Get by ID operation, it retrieves detailed information about a single contact using its unique identifier. This is useful when you need to fetch up-to-date contact details from Zoho Books within an automated workflow.
Common scenarios include:
- Fetching contact details before creating or updating related records.
- Synchronizing contact data between Zoho Books and other systems.
- Retrieving contact information for reporting or notification purposes.
Example: You have a contact ID from a previous step or external source and want to get the full contact record (name, email, phone, etc.) from Zoho Books to use in your workflow.
Properties
| Name | Meaning |
|---|---|
| Contact ID | The unique identifier of the contact to retrieve, update, or delete. |
Output
The node outputs JSON data representing the contact retrieved from Zoho Books. The structure typically includes fields such as:
contact_id: The unique ID of the contact.contact_name: The name of the contact.email: The contact's email address.phone: The contact's phone number.- Other contact-related metadata as provided by Zoho Books.
The output is an array of objects under the json property, each object corresponding to a contact record (in this case, usually one).
No binary data is output by this operation.
Dependencies
- Requires an OAuth2 API credential configured for Zoho Books with access to the organization.
- The credential must include the Zoho Books Organization ID.
- The node makes authenticated HTTP requests to the Zoho Books API endpoint based on the domain specified in the credentials.
Troubleshooting
- Missing Contact ID Error: If the "Contact ID" property is empty when performing "Get by ID", the node will throw an error indicating that the Contact ID is required. Ensure you provide a valid contact ID.
- API Authentication Errors: If the OAuth2 credentials are invalid or expired, the node will fail to authenticate. Refresh or reconfigure the credentials.
- Invalid JSON Errors: For other operations involving JSON input, malformed JSON will cause errors. Although not applicable here, be mindful when using JSON properties.
- Network or API Errors: Any issues communicating with Zoho Books API (rate limits, downtime) will result in error messages containing Zoho Books error codes and messages.