n8n Zoho People Node

A community n8n node for Zoho People integration with OAuth2 authentication and automatic refresh token handling.

Features

• OAuth2 authentication with automatic refresh token management (handled by n8n)
• Multi-region support (US, EU, IN, AU, CN)
• Employee resource operations: Get, Get Many, Create, Update
• Leave Type resource listing
• Type-safe TypeScript implementation

Installation

npm install @trg-admin/n8n-nodes-zoho-people

Configuration

Credentials Setup

1. Create a new credential of type "Zoho People OAuth2 API"
2. Configure your OAuth2 app:
   • Client ID: From your Zoho Developer Console
   • Client Secret: From your Zoho Developer Console
   • Select your region (US, EU, IN, AU, CN)
3. Set appropriate scopes for your use case:
   • Default: ZOHOPEOPLE.leave.ALL ZOHOPEOPLE.attendance.ALL ZOHOPEOPLE.variables.ALL ZOHOPEOPLE.files.ALL ZOHOPEOPLE.performance.ALL ZOHOPEOPLE.orgstructure.ALL ZOHOPEOPLE.organization.READ ZOHOPEOPLE.forms.READ ZOHOPEOPLE.forms.CREATE ZOHOPEOPLE.forms.UPDATE
   • Add additional scopes as needed

The refresh token is automatically managed by n8n - no manual token refresh logic is needed.

Resources

Employee

Manage employee records in Zoho People.

Operations:

• Get: Retrieve a single employee by ID
• Get Many: List employees with pagination
• Create: Create a new employee record
• Update: Update an existing employee record

API Reference: Zoho People API v3 Overview

Leave Type

Retrieve leave types configured in Zoho People.

Operations:

• Get Many: List all leave types

API Reference: Zoho People API v3 Overview

Usage Example

1. Add a "Zoho People" node to your workflow
2. Select "Zoho People OAuth2 API" credential
3. Choose a resource (Employee or Leave Type)
4. Select an operation (Get, Get Many, Create, Update)
5. Fill in the required parameters

Development

Build

npm run build

Type Check

npm run typecheck

Prepare for Publishing

npm run prepublishOnly

Implementation Notes

OAuth2 Flow

• Authorization endpoint: https://accounts.zoho.{region}/oauth/v2/auth
• Token endpoint: https://accounts.zoho.{region}/oauth/v2/token
• Offline access is requested automatically (access_type=offline)
• n8n's requestOAuth2 helper manages refresh tokens transparently

API Base URL Resolution

The node resolves the correct regional API base URL in this priority:

1. Explicit API base URL override from credential (if set)
2. api_domain from OAuth token response
3. Regional inference from token/auth URL
4. Default to US (https://people.zoho.com)

Pagination

The "Get Many" operation uses automatic pagination with configurable page size (default: 100).

Error Handling

Errors from the Zoho API are wrapped using n8n's NodeApiError for proper error reporting in workflows.

License

MIT

Support

For issues, questions, or contributions, refer to the n8n community documentation.