Zoho CRM Custom icon

Zoho CRM Custom

Consume Zoho CRM API

Overview

The Contact - Get Many operation in the Zoho CRM Custom n8n node retrieves multiple contact records from your Zoho CRM account. This operation is useful for scenarios where you need to fetch lists of contacts, filter them by various criteria (such as approval status, conversion status, or territory), and control which fields are returned. Practical applications include synchronizing contacts with other systems, generating reports, or performing bulk updates based on retrieved data.

Example use cases:

  • Fetch all approved contacts for a marketing campaign.
  • Retrieve only converted contacts for sales analysis.
  • List contacts from a specific territory for regional management.

Properties

Name Type Meaning
Return All Boolean Whether to return all results or limit the number of results.
Limit Number The maximum number of results to return (only shown if "Return All" is false).
Options Collection Additional filters and settings for the query.
└ Approved Boolean Whether to retrieve only approved records (defaults to true).
└ Converted Boolean Whether to retrieve only converted records (defaults to false).
└ Fields MultiOptions Specify which fields to return for each contact.
└ Include Child Boolean Whether to include records from child territories.
└ Sort By Options Field to sort records by (selectable from available contact fields).
└ Sort Order Options Ascending or descending order for sorting ("Ascending" or "Descending", default: Descending).
└ Territory ID String Retrieve only records from this specific territory.

Output

  • The output is an array of JSON objects, each representing a contact record from Zoho CRM.
  • Each object contains the fields requested via the "Fields" option, or all standard fields if none are specified.
  • Example output structure:
[
  {
    "id": "1234567890",
    "Last_Name": "Doe",
    "First_Name": "John",
    "Email": "[email protected]",
    "...": "..."
  },
  ...
]
  • No binary data is produced by this operation.

Dependencies

  • Zoho CRM Account: You must have access to a Zoho CRM account.
  • API Credentials: Requires OAuth2 credentials configured in n8n under the name zohoOAuth2Api.
  • n8n Configuration: Ensure the Zoho CRM Custom node is properly installed and credentials are set up.

Troubleshooting

  • Authentication Errors:
    Error message: "Invalid client credentials" or "Unauthorized"
    Resolution: Check that your Zoho OAuth2 credentials are correctly configured in n8n.

  • No Results Returned:
    Possible causes: Filters are too restrictive, or no contacts match the criteria.
    Resolution: Adjust filter options such as "Approved", "Converted", or remove unnecessary filters.

  • Field Selection Issues:
    Error message: "Invalid field(s) selected"
    Resolution: Ensure that the fields specified in the "Fields" option exist in your Zoho CRM Contact module.

  • API Rate Limits:
    Error message: "API rate limit exceeded"
    Resolution: Wait before making more requests, or check your Zoho CRM API usage limits.

Links and References

Discussion