Zoho Recruit icon

Zoho Recruit

Interact with Zoho Recruit API
Join our community

Actions25

Overview

This node integrates with the Zoho Recruit API to manage recruitment-related data. Specifically, for the Note - Create operation, it allows users to create a new note associated with a parent record such as a candidate, job, or client within Zoho Recruit. This is useful in scenarios where recruiters want to add contextual notes or comments linked to specific records in their recruitment workflow.

Practical examples include:

  • Adding interview feedback notes to a candidate's profile.
  • Attaching client communication summaries to a client record.
  • Documenting job-specific remarks on a job opening record.

Properties

Name Meaning
Note Title The title or subject of the note to be created.
Note Content The detailed content or body text of the note.
Parent ID The unique identifier of the parent record (e.g., candidate, job, or client) to which the note will be attached.
SE Module The module type of the parent record. Options: Candidates, Jobs, Clients.

Output

The output JSON contains the response from the Zoho Recruit API after creating the note. Typically, this includes details about the newly created note such as its ID and any metadata returned by the API.

Example structure (simplified):

{
  "data": [
    {
      "id": "1234567890",
      "Note_Title": "Interview Feedback",
      "Note_Content": "Candidate showed excellent skills.",
      "Parent_Id": "987654321",
      "se_module": "Candidates"
    }
  ]
}

No binary data 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 endpoint, which varies based on the region (e.g., .com, .com.au, .eu, etc.).
  • Proper network access to Zoho Recruit API endpoints is necessary.

Troubleshooting

  • Missing Required Fields: If Note Title, Note Content, or Parent ID are not provided, the node throws an error indicating these fields are mandatory.
  • Authentication Errors: If the OAuth token is invalid or expired, API calls will fail. Re-authenticate the credentials in n8n.
  • Invalid Parent ID or Module: Ensure that the Parent ID corresponds to an existing record in the specified SE Module.
  • API Rate Limits: Zoho Recruit may enforce rate limits; if exceeded, requests might be throttled or rejected temporarily.
  • Network Issues: Connectivity problems can cause request failures; verify network access to Zoho Recruit endpoints.

Links and References

Discussion