Actions62
- Account Actions
- Contact Actions
- Deal Actions
- Invoice Actions
- Lead Actions
- Product Actions
- Purchase Order Actions
- Quote Actions
- Sales Order Actions
- Tags Actions
- Vendor Actions
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.