Zoho Recruit icon

Zoho Recruit

Interact with Zoho Recruit API
Join our community

Actions25

Overview

This node operation allows you to change the status of records in various modules within Zoho Recruit, such as Candidates, Applications, Job Openings, and Offers. It is useful for automating updates to the lifecycle or progress state of these records based on your business logic or workflow needs.

Common scenarios include:

  • Updating candidate statuses during recruitment stages (e.g., from "New" to "Qualified").
  • Changing application statuses when a candidate moves forward or is rejected.
  • Modifying job opening statuses to reflect current hiring phases.
  • Adjusting offer statuses to track acceptance or rejection.

For example, you could use this node to automatically mark multiple candidates as "Interview Scheduled" after a batch selection or update offers to "Accepted" once signed.

Properties

Name Meaning
Module The module to change status for. Options: Candidate, Application, Job Opening, Offer
Record IDs Comma-separated list of record IDs to change status for
Job IDs Comma-separated list of job IDs (required only if the module is Application)
Offer ID Unique ID of the offer (required only if the module is Offer)
New Status The new status value to set (e.g., New, Qualified, Rejected)
Comments Optional comments about the status change

Output

The output JSON contains the response from the Zoho Recruit API after attempting to change the status. It typically includes confirmation of the updated records or error details if the operation failed.

Example output structure (simplified):

{
  "data": [
    {
      "ids": ["568998000001714001", "568998000001714002"],
      "Candidate_Status": "Qualified",
      "comments": "Status updated to Qualified"
    }
  ]
}

No binary data is produced by this operation.

Dependencies

  • Requires an OAuth2 API credential configured for Zoho Recruit with appropriate permissions.
  • The node makes authenticated HTTP requests to the Zoho Recruit API endpoints.
  • No additional external dependencies beyond the configured API credentials.

Troubleshooting

  • Missing Required Parameters: The node requires Module, Record IDs, and New Status at minimum. For the Offer module, Offer ID is also mandatory. Ensure these are provided.
  • Invalid Record or Offer IDs: IDs must be valid and correctly formatted. Invalid or missing IDs will cause errors.
  • API Authentication Errors: If the OAuth token is expired or invalid, re-authenticate the Zoho Recruit credentials.
  • Job IDs Requirement: When changing status for the Application module, ensure that Job IDs are provided if required by your use case.
  • Error Messages: The node throws errors if required parameters are missing or if the API returns an error. Review the error message for missing fields or invalid values.

Links and References

Discussion