n8n-nodes-zoho-recruit-trg

n8n community node for Zoho Recruit API v2 using OAuth2 with refresh-token handling delegated to n8n via this.helpers.requestOAuth2.

Authentication model

• Credential extends oAuth2Api.
• Uses authQueryParameters: access_type=offline.
• Uses authentication: body.
• Uses requestOAuth2 for all API calls.
• No custom refresh-token code is implemented.

API base URL resolution order

Resolution order implemented in nodes/ZohoRecruit/GenericFunctions.ts:

1. Explicit credential override (Recruit API Base URL)
2. oauthTokenData.api_domain from OAuth token response
3. Fallback from selected regional OAuth account URL

Regional Recruit API base domains are from Zoho Recruit Multi-DC documentation examples and domain rules.

Endpoint audit (official docs only)

1. Load options: list modules

• Endpoint: GET /recruit/v2/settings/modules
• Docs: https://www.zoho.com/recruit/developer-guide/apiv2/modules-api.html

2. Record APIs

• GET /recruit/v2/{module_api_name}/{record_id}
• GET /recruit/v2/{module_api_name}
• POST /recruit/v2/{module_api_name}
• PUT /recruit/v2/{module_api_name}/{record_id}
• GET /recruit/v2/{module_api_name}/search
• Docs:
  • https://www.zoho.com/recruit/developer-guide/apiv2/get-records.html
  • https://www.zoho.com/recruit/developer-guide/apiv2/insert-records.html
  • https://www.zoho.com/recruit/developer-guide/apiv2/update-records.html
  • https://www.zoho.com/recruit/developer-guide/apiv2/search-records.html

3. Submissions API

• POST /recruit/v2/Submissions
• PUT /recruit/v2/Submissions/{record_id}/actions/status
• Docs:
  • https://www.zoho.com/recruit/developer-guide/apiv2/create-submission.html
  • https://www.zoho.com/recruit/developer-guide/apiv2/change-submission-status.html

4. Assessments API

• POST /recruit/v2.1/Assessments
• PUT /recruit/v2.1/Assessments/{record_id}
• Docs:
  • https://www.zoho.com/recruit/developer-guide/apiv2/create-assessment.html
  • https://www.zoho.com/recruit/developer-guide/apiv2/update-assessment.html

5. Reviews APIs

• POST /recruit/v2/Reviews
• PUT /recruit/v2/Reviews/{record_id}
• Docs:
  • https://www.zoho.com/recruit/developer-guide/apiv2/create-review.html
  • https://www.zoho.com/recruit/developer-guide/apiv2/update-review.html

6. Notes APIs

• GET /recruit/v2/Notes
• POST /recruit/v2/Notes
• PUT /recruit/v2/Notes
• GET /recruit/v2/settings/note_types
• Docs:
  • https://www.zoho.com/recruit/developer-guide/apiv2/get-notes.html
  • https://www.zoho.com/recruit/developer-guide/apiv2/create-notes.html
  • https://www.zoho.com/recruit/developer-guide/apiv2/update-notes.html
  • https://www.zoho.com/recruit/developer-guide/apiv2/get-note-type.html

7. Files & Attachments APIs

• GET /recruit/v2/{module_api_name}/{record_id}/Attachments
• POST /recruit/v2/{module_api_name}/{record_id}/Attachments
• POST /recruit/v2/{module_api_name}/{record_id}/photo
• POST /recruit/v2/Candidates/actions/import_document
• Docs:
  • https://www.zoho.com/recruit/developer-guide/apiv2/get-attachments.html
  • https://www.zoho.com/recruit/developer-guide/apiv2/upload-attachment.html
  • https://www.zoho.com/recruit/developer-guide/apiv2/upload-image.html
  • https://www.zoho.com/recruit/developer-guide/apiv2/upload-document.html

8. Bulk API (Bulk Read)

• POST /recruit/bulk/v2/read
• GET /recruit/bulk/v2/read/{job_id}
• Docs:
  • https://www.zoho.com/recruit/developer-guide/apiv2/bulk-read/create-job.html
  • https://www.zoho.com/recruit/developer-guide/apiv2/bulk-read/job-details.html

Multipart operations note

The APIs for attachment/photo/document upload are multipart-focused in official docs. This node currently sends the provided JSON body as-is for those operations, so binary upload mapping may require a follow-up enhancement for full multipart handling.

OAuth references

• Authorization request and access_type=offline: https://www.zoho.com/recruit/developer-guide/apiv2/auth-request.html
• Token response with api_domain: https://www.zoho.com/recruit/developer-guide/apiv2/access-refresh.html
• Multi-DC domain behavior: https://www.zoho.com/recruit/developer-guide/apiv2/multi-dc.html

Documented ambiguity flagged

Zoho Recruit scope examples have inconsistent casing in docs (ZohoRecruit... vs ZohoRECRUIT...). This package keeps scope as an editable string field so users can align with their tenant behavior and official updates.

Build

npm run typecheck
npm run build

Publish safety

Check whether target version exists before publishing:

npm view n8n-nodes-zoho-recruit-trg versions --json

If target version exists, bump and publish:

npm version patch
npm publish --access public