n8n-nodes-zohopeople-easyautomate

📋 Table of Contents

• About
• Features
• Installation
  • Via n8n Community Nodes
  • Via npm
  • Via Docker
• Configuration
  • Step 1: Create OAuth Application in Zoho
  • Step 2: Configure Credentials in n8n
• Usage
• Usage Examples
• Requirements
• Development
• License
• Author

🎯 About

n8n-nodes-zohopeople-easyautomate is an official community node for n8n that enables integration with Zoho People API. This node allows you to automate HR processes, manage employee data, track time, handle leaves, attendance, and much more - all within the powerful n8n automation engine.

✨ Features

This node provides support for 7 main Zoho People resources:

📝 Forms

• Fetch list of forms
• Get bulk records with tabular sections
• Get record count in forms

📅 Attendance

• Employee check-in/check-out
• Bulk attendance import
• Fetch last attendance entries
• Employee shift details
• Get attendance entries for specific date
• Regularization records
• Update user shifts

💼 Cases

• List case categories
• View case details

🏖️ Leave

• Add leave (day-based and hour-based)
• Cancel leave
• Get leave types
• Get holidays
• Advanced leave records retrieval (V2 API)
• Single leave record
• User reports
• Booked and balance reports
• Bradford reports
• Encashment reports

⏱️ Timer

• Start timer
• Pause timer
• Resume timer
• Get currently running timer
• Add comments
• Get comments
• Delete comments

📊 Timesheet

• Approve or reject timesheets
• Create timesheets
• Delete timesheets
• Get specific timesheet details
• Get timesheets list
• Modify timesheets

👁️ View

• Default and custom views
• Fetch views for specific form

📦 Installation

1. Via n8n Community Nodes (Recommended)

This is the easiest installation method:

1. Open your n8n instance
2. Go to Settings → Community Nodes
3. Click Install a community node
4. Type: n8n-nodes-zohopeople-easyautomate
5. Click Install

2. Via npm

If you're managing n8n locally, you can install the node using npm:

cd ~/.n8n/nodes
npm install n8n-nodes-zohopeople-easyautomate

Or in your n8n root directory:

npm install n8n-nodes-zohopeople-easyautomate

After installation, restart n8n:

n8n start

3. Via Docker

If you're using n8n in a Docker container, add the following line to your Dockerfile before the font installation command:

RUN cd /usr/local/lib/node_modules/n8n && npm install n8n-nodes-zohopeople-easyautomate

Complete Dockerfile example:

FROM n8nio/n8n

USER root

# Install Zoho People node
RUN cd /usr/local/lib/node_modules/n8n && npm install n8n-nodes-zohopeople-easyautomate

# Rest of configuration...
USER node

Then rebuild and run the container:

docker build -t n8n-custom .
docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8n-custom

For docker-compose:

version: '3.8'

services:
  n8n:
    image: n8nio/n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=password
    volumes:
      - ~/.n8n:/home/node/.n8n
    command: >
      /bin/sh -c "
      cd /usr/local/lib/node_modules/n8n &&
      npm install n8n-nodes-zohopeople-easyautomate &&
      n8n start
      "

🔐 Configuration

Step 1: Create OAuth Application in Zoho

Before using the node, you need to configure OAuth2 in Zoho Developer Console:

1. Log in to Zoho API Console:

   • Go to https://api-console.zoho.com/
   • Sign in with your Zoho account

2. Create a new application:

   • Click Add Client
   • Select Server-based Applications

3. Fill in application details:

   • Client Name: n8n Zoho People Integration (or any name)
   • Homepage URL: Your n8n instance URL (e.g., https://your-domain.com)
   • Authorized Redirect URIs:

     https://your-domain.com/rest/oauth2-credential/callback

     ⚠️ Important: Replace your-domain.com with your actual n8n instance URL

4. Save application credentials:

   • After creating the application, save:
     • Client ID
     • Client Secret
   • You'll need these in the next step

Step 2: Configure Credentials in n8n

1. Open n8n:

   • Go to Credentials in the main menu
   • Click New → Search for Zoho People OAuth2 API

2. Fill in OAuth2 credentials:

   | Field | Value | Description | |-------|-------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------| | API Domain | Select your region | 🇺🇸 US / 🇪🇺 EU / 🇦🇺 AU / 🇮🇳 IN / 🇨🇳 CN.IMPORTANT: The Zoho OAuth2 returns a URL, but it is incorrect for Zoho People API and should not be used as-is. | | Client ID | Your Client ID | From Zoho API Console | | Client Secret | Your Client Secret | From Zoho API Console | | Authorization URL | Automatic | Depends on region | | Access Token URL | Select region | US/EU/AU/IN/CN |

3. Authorize:

   • Click Connect my account
   • Log in to Zoho and accept permissions
   • After successful authorization, you'll see a green "Connected" status

4. Save credentials:

   • Click Save

🚀 Usage

Basic Usage

1. Create a new workflow in n8n
2. Add Zoho People node
3. Select or create credentials (OAuth2)
4. Select Resource
5. Select Operation
6. Fill in required fields
7. Execute the workflow

Simple Workflow Example

[Trigger: Webhook or Cron] → [Zoho People: Get Leave Types] → [Set Node] → [Email Node]

🎓 Usage Examples

Example 1: Automated Leave Reporting

Goal: Send daily email with today's leave list every morning.

Workflow:

[Cron: 7:00 AM daily]
  → [Zoho People: Get Leave Records V2]
      - from: {{$now.format('yyyy-MM-dd')}}
      - to: {{$now.format('yyyy-MM-dd')}}
      - approvalStatus: ["APPROVED"]
  → [Function: Format data]
  → [Gmail: Send Email]

Example 2: Attendance Sync from Biometric System

Goal: Sync data from biometric system every 5 minutes.

Workflow:

[Cron: Every 5 minutes]
  → [HTTP Request: Fetch from biometric system]
  → [Function: Transform data]
  → [Zoho People: Attendance Bulk Import]
  → [Slack: Notify on error]

Example 3: Automatic Timer Start

Goal: Start timer when employee begins work on Jira task.

Workflow:

[Jira Trigger: Issue updated]
  → [IF: Status = "In Progress"]
  → [Zoho People: Start Timer]
      - jobId: {{$json["issue"]["key"]}}
      - workDate: {{$now.format('yyyy-MM-dd')}}
  → [Slack: Notify user]

Example 4: Weekly Time Report

Goal: Generate and send time report to manager every Friday.

Workflow:

[Cron: Friday 5:00 PM]
  → [Zoho People: Get Timesheets]
      - user: "all"
      - approvalStatus: "pending"
  → [Function: Generate report]
  → [Google Sheets: Append data]
  → [Gmail: Send to manager]

Example 5: Unapproved Timesheet Reminder

Goal: Send reminder to employees with unapproved timesheets.

Workflow:

[Cron: Monday 9:00 AM]
  → [Zoho People: Get Timesheets]
      - approvalStatus: "draft"
  → [Split In Batches]
  → [Gmail: Send reminder]
      - To: {{$json["email"]}}

💻 Requirements

• n8n: v0.200.0 or newer
• Node.js: 20.19 or newer
• Zoho People: Active account with API access
• OAuth2: Configured application in Zoho API Console

🛠️ Development

Building from Source

# Clone repository
git clone https://github.com/kamilfityka/n8n-nodes-zohopeople-easyautomate.git

# Navigate to directory
cd n8n-nodes-zohopeople-easyautomate

# Install dependencies
npm install

# Build project
npm run build

# Run linter
npm run lint

# Run tests
npm test

Project Structure

n8n-nodes-zohopeople-easyautomate/
├── nodes/
│   └── ZohoPeople/
│       ├── ZohoPeople.node.ts          # Main node file
│       ├── GenericFunctions.ts          # API helper functions
│       ├── types.d.ts                   # Type definitions
│       ├── descriptions/                # Parameter descriptions
│       │   ├── AttendanceDescription.ts
│       │   ├── CasesDescription.ts
│       │   ├── FormDescription.ts
│       │   ├── LeaveDescription.ts
│       │   ├── SharedFields.ts
│       │   ├── TimerDescription.ts
│       │   ├── TimesheetDescription.ts
│       │   └── ViewDescription.ts
│       └── operations/                  # Operation logic
│           ├── AttendanceOperations.ts
│           ├── CasesOperations.ts
│           ├── FormOperations.ts
│           ├── LeaveOperations.ts
│           ├── TimerOperations.ts
│           ├── TimesheetOperations.ts
│           └── ViewOperations.ts
├── credentials/
│   └── ZohoPeopleOAuth2Api.credentials.ts
├── package.json
├── tsconfig.json
└── README.md

Available Scripts

• npm run build - Compile TypeScript and copy files
• npm run dev - Watch mode for development
• npm run format - Format code using Prettier
• npm run lint - Check code using ESLint
• npm run lintfix - Fix ESLint issues automatically
• npm test - Run Jest tests

📄 License

This project is licensed under Apache 2.0 with Commons Clause - see LICENSE.md for details.

Commons Clause means that:

• ✅ You can use this software for free
• ✅ You can modify the code
• ✅ You can distribute modified versions
• ❌ You cannot sell commercial versions of this software as a service

👨‍💻 Author

Kamil Fityka

• Email: [email protected]
• GitHub: @kamilfityka
• Company: EasyAutomate

🙏 Support

If this project is helpful, please consider:

• ⭐ Starring the repository on GitHub
• 🐛 Reporting bugs via Issues
• 🔧 Submitting Pull Requests with improvements
• 📖 Improving documentation

🔗 Useful Links

• n8n Documentation
• Zoho People API Documentation
• n8n Community
• Zoho People