Actions25
- Attachment Actions
- User Actions
- Associated Actions
- Candidate Actions
- Note Actions
- Note Type Actions
- Photo Actions
- Profile Actions
- Role Actions
- Status Actions
Overview
This node integrates with the Zoho Recruit API to manage candidate records and related data. Specifically, the Candidate - Search operation allows users to search for candidates in Zoho Recruit using custom search criteria formatted according to Zoho's query syntax.
Typical use cases include:
- Finding candidates by specific attributes such as email, name, or status.
- Filtering candidates based on complex conditions (e.g., multiple fields combined).
- Automating recruitment workflows by dynamically retrieving candidate data matching certain criteria.
For example, a user might search for candidates whose email equals "example@domain.com" using the criteria ((Email:equals:example@domain.com)).
Properties
| Name | Meaning |
|---|---|
| Search Criteria | The search query string in Zoho's format to filter candidates. Example: ((Email:equals:example@domain.com)) |
Output
The output is an array of candidate records matching the search criteria. Each item in the output contains a json field with the candidate data returned from Zoho Recruit.
The structure corresponds directly to Zoho Recruit's candidate data schema, typically including fields like candidate ID, name, email, phone, skills, experience, etc.
No binary data is output for this operation.
Dependencies
- Requires an OAuth2 API credential configured for Zoho Recruit to authenticate requests.
- The node uses Zoho Recruit's REST API endpoints under the base URL determined by the OAuth token region (e.g.,
https://recruit.zoho.comor regional equivalents). - Proper API permissions are needed to perform candidate searches.
Troubleshooting
- Invalid Search Criteria Format: If the search criteria string is malformed or does not follow Zoho's expected syntax, the API may return errors or no results. Ensure the criteria string matches Zoho's documented format.
- Authentication Errors: If the OAuth token is expired or invalid, requests will fail. Re-authenticate the credentials in n8n.
- Empty Results: If no candidates match the criteria, the output will be empty. Verify the correctness of the search criteria.
- API Rate Limits: Zoho Recruit enforces rate limits; excessive requests may result in throttling errors.