Zoho CRM Custom icon

Zoho CRM Custom

Consume Zoho CRM API

Overview

This node allows you to delete a contact from Zoho CRM by specifying the Contact ID. It is useful in automation workflows where you need to remove outdated, duplicate, or incorrect contact records from your Zoho CRM system. For example, you might use this node after verifying that a contact has unsubscribed or requested data deletion, or as part of a deduplication process.

Properties

Name Type Meaning
Contact ID String ID of the contact to delete. This uniquely identifies the contact record in Zoho CRM that will be deleted.

Output

The output is a JSON object containing details about the deleted contact operation as returned by the Zoho CRM API. The structure typically includes confirmation and metadata about the deletion, such as:

{
  "id": "1234567890",
  "message": "record deleted",
  "status": "success"
}
  • id: The unique identifier of the deleted contact.
  • message: Status message from Zoho CRM (e.g., "record deleted").
  • status: Operation status (e.g., "success").

If an error occurs and "Continue On Fail" is enabled, the output will include an error field with the error message.

Dependencies

  • Zoho CRM Account: You must have access to a Zoho CRM account.
  • n8n Credentials: The node requires OAuth2 credentials for Zoho CRM (zohoOAuth2Api) to authenticate API requests.
  • API Access: Ensure your Zoho CRM user has permission to delete contacts.

Troubleshooting

Common Issues:

  • Invalid Contact ID: If the provided Contact ID does not exist, the node will throw an error indicating the record was not found.
  • Insufficient Permissions: If the connected Zoho CRM user lacks permission to delete contacts, the operation will fail.
  • Authentication Errors: Expired or misconfigured OAuth2 credentials can cause authentication failures.

Error Messages and Resolutions:

  • "record not found": Verify that the Contact ID is correct and exists in Zoho CRM.
  • "permission denied": Check the permissions of the Zoho CRM user associated with the credentials.
  • "invalid authentication": Reconnect or refresh your Zoho CRM OAuth2 credentials in n8n.

Links and References

Discussion