npm package: @parthikhm/n8n-nodes-zoho-recruit
Description: Ultra-lightweight Zoho Recruit Node for n8n with comprehensive ATS management.

Features: Job Openings, Candidates, Photos, Users, Organization, Profiles & Roles.

Complete recruitment automation with pagination, query parameters, and OAuth2 authenticatio
Author: Parthik Modi
Latest version: 0.1.8

# n8n-nodes-zoho-recruit

This is an n8n community node. It lets you use Zoho Recruit in your n8n workflows.

Zoho Recruit is a comprehensive recruitment management system that helps streamline the hiring process from candidate sourcing to onboarding.

🚀 **Ultra-Lightweight**: Only **16.1 kB** package size.

[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

[Installation](#installation)  
[Operations](#operations)  
[Credentials](#credentials)  
[Compatibility](#compatibility)  
[Resources](#resources)  
[Version history](#version-history)

## Installation

Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

```bash
npm install n8n-nodes-zoho-recruit
```

## Operations

### Candidates

- Get All, Get, Create, Update, Delete, Search

### Job Openings

- Get Many (with pagination, limit, and query parameters)

### Notes

- Get Many, Create, Update, Delete

### Note Types

- Get Many

### Attachments

- Get Many, Upload, Download, Delete

### Status

- Change Status

### Associated

- Get Associated Records

### Photo

- Upload a Photo, Download a Photo, Delete a Photo

### Organization

- Get Organization Details

### Profiles

- Get All Profiles, Get Profile

### Roles

- Get All Roles, Get Role

### User

- Get Users

## Credentials

### Prerequisites

Create a Zoho Recruit API application:

1. Log into Zoho Recruit
2. Go to Setup → Developer Space → API
3. Create Self-Client
4. Configure Scopes

### Required Scopes

**Candidates:** ZohoRecruit.modules.candidates.ALL, READ, CREATE, UPDATE, DELETE
**Notes:** ZohoRecruit.modules.notes.ALL, READ, CREATE, UPDATE, DELETE
**Attachments:** ZohoRecruit.modules.attachments.ALL, READ, CREATE, DELETE
**Note Types:** ZohoRecruit.settings.note_type.ALL, READ
**Photos:** ZohoRecruit.modules.all, ZohoRecruit.modules.candidate.ALL, ZohoRecruit.modules.contact.ALL
**Users:** ZohoRecruit.users.ALL, READ
**Organization:** ZohoRecruit.org.all
**Profiles:** ZohoRecruit.settings.profiles.ALL, READ
**Roles:** ZohoRECRUIT.settings.roles.ALL, READ

### Setting Up Credentials in n8n

1. Go to Settings → Credentials
2. Add New Credential
3. Select Zoho Recruit OAuth2 API
4. Fill in the Details:

   **Global:** Client ID, Client Secret, Access Token URL: https://accounts.zoho.com/oauth/v2/token, Authorization URL: https://accounts.zoho.com/oauth/v2/auth
   **Australia:** Access Token URL: https://accounts.zoho.com.au/oauth/v2/token, Authorization URL: https://accounts.zoho.com.au/oauth/v2/auth
   **China:** Access Token URL: https://accounts.zoho.com.cn/oauth/v2/token, Authorization URL: https://accounts.zoho.com.cn/oauth/v2/auth
   **Europe:** Access Token URL: https://accounts.zoho.eu/oauth/v2/token, Authorization URL: https://accounts.zoho.eu/oauth/v2/auth
   **India:** Access Token URL: https://accounts.zoho.in/oauth/v2/token, Authorization URL: https://accounts.zoho.in/oauth/v2/auth

5. Save and Test

### Supported Regions

- Global: `https://recruit.zoho.com`
- Australia: `https://recruit.zoho.com.au`
- China: `https://recruit.zoho.com.cn`
- Europe: `https://recruit.zoho.eu`
- India: `https://recruit.zoho.in`

## Compatibility

- **Minimum n8n version**: 0.200.0
- **Tested with n8n versions**: 1.0.0+
- **Node.js version**: 18.x or higher

## Resources

- [n8n community nodes documentation](https://docs.n8n.io/integrations/#community-nodes)
- [Zoho Recruit API Documentation](https://www.zoho.com/recruit/developer-guide/)
- [GitHub Issues](https://github.com/parthikhm/n8n-nodes-zoho-recruit/issues)
- [n8n Community Forum](https://community.n8n.io/)

## Version history

### 0.1.8 (Latest)

- NEW: Job Openings Resource - Get job openings with pagination and query parameters

### 0.1.7

- NEW: Roles Resource - Get all roles and specific role by ID
- NEW: Profiles Resource - Get all profiles and specific profile by ID
- NEW: Organization Resource - Get organization details (iso_code, mc_status)

### 0.1.6

- NEW: Photo Resource - Complete photo management for Candidates and Contacts
- NEW: User Resource - Comprehensive user management with 10 different user type filters
- NEW: Attachment Download - Download attachments as binary files
- IMPROVED: File Handling - Enhanced binary file processing
- IMPROVED: Error Handling - More detailed error messages and validation
- IMPROVED: Code Quality - Fixed TypeScript linter errors and improved formatting

### 0.1.5

- Added attachment upload functionality for all modules
- Fixed TypeScript linter errors and improved code quality

### 0.1.4

- Bug fixes and performance improvements

### 0.1.3

- Added Associated Records resource with pagination support

### 0.1.2

- Reduced package size by 47% (16.1 kB)
- Performance optimizations

### 0.1.1

- Initial release with Candidates, Notes, Attachments, and Status resources
- OAuth2 authentication and pagination support

## License

[MIT](LICENSE.md)