Overview
The "Contacts: Delete" operation in the Zoho Books custom n8n node allows users to delete a specific contact from their Zoho Books account by providing the Contact ID. This is useful for automating data cleanup, managing outdated or duplicate contacts, and maintaining an up-to-date contact list within your accounting workflows.
Practical examples:
- Automatically remove contacts that have been marked as inactive in another system.
- Clean up test or demo contacts after running onboarding or integration tests.
- Integrate with CRM systems to ensure deleted customers are also removed from Zoho Books.
Properties
| Name | Type | Meaning |
|---|---|---|
| Contact ID | String | The unique identifier of the contact to be deleted from Zoho Books. Required for deletion. |
Output
- json: The output will typically contain the response from the Zoho Books API regarding the deletion request. This may include:
- A success message or status indicating the contact was deleted.
- Any error messages if the contact could not be found or deleted.
Example output (success):
{
"code": 0,
"message": "The contact has been deleted."
}
Example output (error):
{
"code": 1001,
"message": "Contact not found."
}
Dependencies
- External Service: Requires access to the Zoho Books API.
- Authentication: Needs valid OAuth2 credentials configured in n8n (
zohoBooksOAuth2Api). - n8n Configuration: Ensure the Zoho Books node is properly set up with the correct base URL (
https://books.zoho.in/api/v3).
Troubleshooting
Common issues:
- Invalid Contact ID: If the provided Contact ID does not exist, the API will return an error such as "Contact not found."
- Missing Credentials: If OAuth2 credentials are not configured or have expired, authentication errors will occur.
- Insufficient Permissions: The connected Zoho Books account must have permission to delete contacts.
Error messages and resolutions:
"Contact not found.": Double-check the Contact ID for typos or confirm the contact exists in Zoho Books.- Authentication errors: Reconnect or refresh your Zoho Books OAuth2 credentials in n8n.
- Permission denied: Ensure your Zoho Books user role allows deleting contacts.