Overview
The "Zoho Books" custom n8n node enables automation workflows to interact with the Zoho Books API. Specifically, for the Contacts resource and the Get operation, this node retrieves detailed information about a specific contact in your Zoho Books account using the provided Contact ID. This is useful for scenarios such as:
- Fetching up-to-date contact details for use in subsequent workflow steps.
- Verifying or displaying customer information before processing invoices or orders.
- Integrating Zoho Books contacts with other systems (e.g., CRM, email marketing).
Example Use Cases:
- Retrieve a customer's full profile to personalize communications.
- Validate a contact's existence before creating related records (like invoices).
- Sync Zoho Books contacts with another database.
Properties
| Name | Type | Meaning |
|---|---|---|
| Contact ID | String | The unique identifier of the contact to retrieve from Zoho Books. Required for fetching a specific contact's details. |
Output
The node outputs a json object containing the details of the requested contact. The structure typically includes fields such as:
{
"contact_id": "1234567890",
"contact_name": "John Doe",
"company_name": "Acme Corp",
"email": "john.doe@example.com",
"phone": "+1-555-1234",
// ...additional contact fields as returned by Zoho Books API
}
Note: The exact output fields depend on the Zoho Books API response for the contact.
Dependencies
- External Service: Requires access to the Zoho Books API.
- Authentication: Needs valid OAuth2 credentials configured in n8n under the name
zohoBooksOAuth2Api. - n8n Configuration: Ensure the Zoho Books OAuth2 credential is set up and authorized.
Troubleshooting
Invalid or Missing Contact ID:
If the Contact ID is missing or incorrect, the node may return an error such as "Contact not found" or a 404 status code.
Resolution: Double-check that the Contact ID exists in your Zoho Books account.Authentication Errors:
Errors like "Invalid authentication" or 401 Unauthorized indicate issues with the OAuth2 credentials.
Resolution: Reauthorize or update the Zoho Books OAuth2 credentials in n8n.API Limitations:
Hitting Zoho Books API rate limits may result in errors or throttling.
Resolution: Review Zoho Books API usage and adjust workflow frequency if needed.