Zoho Recruit icon

Zoho Recruit

Interact with Zoho Recruit API
Join our community

Actions25

Overview

This node operation "Get Associated Records" for the "Associated" resource in Zoho Recruit allows users to retrieve records that are linked or related to a specific record within the Zoho Recruit system. For example, it can fetch job openings associated with a candidate or candidates associated with a job opening.

Common scenarios where this node is beneficial include:

  • Fetching all job openings linked to a particular candidate, optionally filtered by posting title.
  • Retrieving all candidates associated with a specific job opening, optionally filtered by candidate statuses.
  • Paginating through large sets of associated records when there are many links.

Practical examples:

  • A recruiter wants to see all job openings a candidate has applied to or is associated with.
  • A hiring manager wants to list all candidates currently associated with a particular job opening and filter them by their application status (e.g., "Contacted", "Associated").
  • Automating workflows that need to process or analyze relationships between candidates and job openings.

Properties

Name Meaning
Module The module to get associated records for. Options: "Candidate", "Job Opening".
Record ID The unique ID of the record to get associated records for.
Posting Title (Optional) Filter to get associated job openings for a candidate with this posting title.
Candidate Statuses (Optional) Filter to get associated candidates for a job opening with these statuses (comma-separated).
Return All Whether to return all results or only up to a given limit (boolean).
Limit Max number of results to return if "Return All" is false.
Page Page number to retrieve (default is 1).
Per Page Number of records per page (default is 200).

Output

The output is an array of JSON objects representing the associated records retrieved from Zoho Recruit. Each item corresponds to one associated record and contains fields as returned by the Zoho Recruit API for the respective module.

  • The json field contains the data of each associated record.
  • Pagination info such as page, per_page, count, and more_records is handled internally but not explicitly output unless included in the API response.
  • No binary data output is produced by this operation.

Dependencies

  • Requires an OAuth2 API credential configured for Zoho Recruit to authenticate API requests.
  • The node uses the Zoho Recruit REST API endpoints, which vary depending on the region of the OAuth token.
  • Network access to Zoho Recruit API endpoints is required.

Troubleshooting

  • Missing or invalid Module or Record ID: The node requires both the module and record ID parameters to be set correctly. Ensure these are provided and valid numeric strings.
  • API authentication errors: If the OAuth token is expired or invalid, re-authenticate the Zoho Recruit credentials.
  • Pagination issues: When "Return All" is enabled, the node automatically paginates through all pages. If you experience incomplete data, verify API limits or network connectivity.
  • Filtering parameters: Incorrect formatting of Posting Title or Candidate Statuses filters may result in no data returned. Use comma-separated values without extra spaces.
  • Rate limiting: Zoho API may throttle requests; handle errors accordingly or reduce request frequency.

Links and References

This summary covers the static analysis of the "Get Associated Records" operation for the "Associated" resource in the Zoho Recruit node implementation.

Discussion