Zoho CRM Custom icon

Zoho CRM Custom

Consume Zoho CRM API

Overview

The Zoho CRM Custom node for n8n allows you to interact with the Zoho CRM API. Specifically, when configured with the Resource: Lead and Operation: Delete, this node deletes a lead from your Zoho CRM account based on the provided Lead ID.

Common scenarios:

  • Automating the cleanup of outdated or invalid leads in Zoho CRM.
  • Removing leads as part of a data hygiene workflow.
  • Integrating with other systems to automatically delete leads under certain conditions (e.g., after conversion or disqualification).

Practical example:
Suppose you have a workflow that identifies duplicate or unqualified leads. You can use this node to automatically remove those leads from Zoho CRM by passing their IDs.


Properties

Name Type Meaning
Lead ID String ID of the lead to delete in Zoho CRM. This is required and uniquely identifies which lead will be deleted.

Output

The output is a JSON object containing details about the deletion operation. Typically, it includes confirmation information such as the ID of the deleted lead and possibly a status message from Zoho CRM.

Example output:

{
  "id": "1234567890",
  "message": "record deleted",
  "status": "success"
}

Note: The exact structure may vary depending on Zoho CRM's API response.


Dependencies

  • External Service: Requires access to a Zoho CRM account.
  • Authentication: Needs valid Zoho OAuth2 credentials configured in n8n (zohoOAuth2Api).
  • n8n Configuration: Ensure the Zoho CRM OAuth2 credential is set up in your n8n instance.

Troubleshooting

Common issues:

  • Invalid Lead ID: If the provided Lead ID does not exist, the node will return an error from Zoho CRM indicating the record was not found.
  • Missing Credentials: If Zoho OAuth2 credentials are not configured or have expired, authentication errors will occur.
  • Insufficient Permissions: The connected Zoho user must have permission to delete leads; otherwise, a permission error will be returned.

Error messages and resolutions:

  • "Record not found": Check that the Lead ID is correct and exists in Zoho CRM.
  • "Invalid OAuth token" or "Authentication failed": Reconnect or refresh your Zoho OAuth2 credentials in n8n.
  • "Permission denied": Ensure the Zoho user has sufficient rights to delete leads.

Links and References

Discussion