@trg-admin/n8n-nodes-zoho-desk 0.1.0

package/README.md

@@ -0,0 +1,312 @@
+# n8n Zoho Desk Node
+
+A comprehensive n8n community node for **Zoho Desk** with automatic OAuth2 token refresh handling, supporting Tickets, Contacts, and Comments.
+
+## ✨ Features
+
+- **Automatic Token Refresh**: Uses OAuth2 with refresh tokens - no manual token management needed
+- **Multi-Region Support**: Automatically detects and uses the correct Zoho data center (US, EU, IN, AU, CN)
+- **Combined CRM & Desk Access**: Single credential works for both Zoho CRM and Zoho Desk nodes
+- **Comprehensive Operations**:
+  - **Tickets**: Create, Get, Get Many, Update
+  - **Contacts**: Create, Get, Get Many, Search, Update
+  - **Comments**: Add, Get Many
+
+## 🔐 Authentication Setup
+
+This node uses a **custom OAuth2 credential** (`zohoCRMDeskOAuth2Api`) that properly handles refresh tokens and multi-region support.
+
+### Step 1: Create OAuth2 App in Zoho API Console
+
+1. Go to [Zoho API Console](https://api-console.zoho.com/)
+2. Click **ADD CLIENT** → **Server-based Applications**
+3. Fill in:
+  - **Client Name**: `n8n Integration` (or your preferred name)
+  - **Homepage URL**: `https://your-n8n-instance.com`
+  - **Authorized Redirect URI**: `https://your-n8n-instance.com/rest/oauth2-credential/callback`
+4. Click **CREATE**
+5. Copy the **Client ID** and **Client Secret** (you'll need these in n8n)
+
+### Step 2: Configure Scopes
+
+When you create the credential in n8n, the default scope is:
+
+```
+ZohoCRM.modules.ALL Desk.tickets.ALL Desk.contacts.ALL Desk.search.READ
+```
+
+**Available Zoho Desk Scopes:**
+- `Desk.tickets.ALL` - Full access to tickets
+- `Desk.contacts.ALL` - Full access to contacts  
+- `Desk.search.READ` - Search across modules
+- `Desk.settings.ALL` - Access to settings and configurations
+- `Desk.tasks.ALL` - Task management
+- `Desk.basic.READ` - Read-only access to basic information
+
+You can customize the scope field in the credential to add or remove permissions as needed.
+
+### Step 3: Get Your Organization ID
+
+1. Log in to [Zoho Desk](https://desk.zoho.com/)
+2. Go to **Setup** (gear icon) → **Developer Space** → **API**
+3. Copy your **Organization ID** (looks like: `12345678`)
+4. You'll enter this as a parameter in each Zoho Desk node
+
+### Step 4: Configure Credential in n8n
+
+1. In n8n, go to **Credentials** → **New**
+2. Search for **Zoho CRM & Desk OAuth2 API**
+3. Fill in:
+  - **Authorization URL**: Select your region (e.g., `https://accounts.zoho.com/oauth/v2/auth` for US)
+  - **Access Token URL**: Select matching region (e.g., `https://accounts.zoho.com/oauth/v2/token` for US)
+  - **Client ID**: From Step 1
+  - **Client Secret**: From Step 1
+  - **Scope**: Default works for most cases, customize if needed
+4. Click **Connect my account**
+5. Authorize access in Zoho
+6. ✅ Credential is ready to use!
+
+### Regional Mapping
+
+Select the **same region** for both Authorization URL and Access Token URL:
+
+| Region | Authorization URL | Access Token URL |
+|--------|-------------------|------------------|
+| **US** | `https://accounts.zoho.com/oauth/v2/auth` | `https://accounts.zoho.com/oauth/v2/token` |
+| **EU** | `https://accounts.zoho.com/oauth/v2/auth` | `https://accounts.zoho.eu/oauth/v2/token` |
+| **India** | `https://accounts.zoho.com/oauth/v2/auth` | `https://accounts.zoho.in/oauth/v2/token` |
+| **Australia** | `https://accounts.zoho.com/oauth/v2/auth` | `https://accounts.zoho.com.au/oauth/v2/token` |
+| **China** | `https://accounts.zoho.com.cn/oauth/v2/auth` | `https://accounts.zoho.com.cn/oauth/v2/token` |
+
+**Note**: The API domain (e.g., `https://desk.zoho.com`) is automatically detected from the OAuth response - you don't need to configure it manually.
+
+## 📦 Installation
+
+### Option 1: Install from npm (when published)
+
+```bash
+npm install n8n-nodes-zoho -g
+```
+
+### Option 2: Local Development
+
+1. Clone this repository:
+  ```bash
+  git clone <your-repo-url>
+  cd n8n-nodes-zoho
+  ```
+
+2. Install dependencies and build:
+  ```bash
+  npm install
+  npm run build
+  ```
+
+3. Link to your n8n instance:
+  ```bash
+  npm link
+  ```
+
+4. In your n8n installation directory:
+  ```bash
+  npm link n8n-nodes-zoho
+  ```
+
+5. Restart n8n
+
+## 🚀 Usage Examples
+
+### Create a Ticket
+
+**Resource**: Ticket  
+**Operation**: Create  
+**Parameters**:
+- **Organization ID**: `12345678`
+- **Subject**: `Unable to log in`
+- **Contact Email**: `customer@example.com`
+- **Department ID**: `987654321`
+- **Description**: `Customer reports they cannot access their account`
+- **Additional Fields**:
+  - Priority: `High`
+  - Status: `Open`
+
+### Search for Contacts
+
+**Resource**: Contact  
+**Operation**: Search  
+**Parameters**:
+- **Organization ID**: `12345678`
+- **Search Query**: `john@example.com`
+- **Limit**: `10`
+
+### Add Comment to Ticket
+
+**Resource**: Comment  
+**Operation**: Add  
+**Parameters**:
+- **Organization ID**: `12345678`
+- **Ticket ID**: `123456`
+- **Content**: `Thank you for contacting support. We're looking into this issue.`
+- **Is Public**: `✓` (visible to customer)
+- **Content Type**: `Plain Text`
+
+## 🔧 How Token Refresh Works
+
+This node uses n8n's built-in OAuth2 framework with `requestOAuth2`, which provides automatic token refresh:
+
+1. **Initial Authorization**: When you connect the credential, Zoho returns:
+  - Access token (valid for ~1 hour)
+  - Refresh token (long-lived)
+  - Regional API domain
+
+2. **Automatic Refresh**: When the access token expires:
+  - n8n detects the 401 error
+  - Automatically calls Zoho's token endpoint with the refresh token
+  - Updates the stored access token
+  - Retries the original request
+  - **You never see the error or interruption**
+
+3. **No Manual Intervention**: Unlike custom API key implementations, you never need to manually refresh tokens or update credentials.
+
+## 🤔 Why Not Use the Built-in `zohoOAuth2Api`?
+
+The built-in Zoho CRM credential (`zohoOAuth2Api`) has **hardcoded scopes** for CRM only:
+
+```typescript
+scope: 'ZohoCRM.modules.ALL,ZohoCRM.settings.all,ZohoCRM.users.all'
+```
+
+The scope property is `type: 'hidden'`, so users cannot modify it to add Desk permissions. This is why we created a custom credential that:
+- Extends the same OAuth2 framework
+- Allows editable scopes
+- Defaults to both CRM and Desk permissions
+- Uses the exact same token refresh mechanism
+
+## 🐛 Troubleshooting
+
+### "INVALID_OAUTH" or "Authentication failed" errors
+
+**Cause**: Credentials may be using the wrong region  
+**Fix**: Ensure Authorization URL and Access Token URL match your Zoho account region
+
+### "Invalid OrgId" error
+
+**Cause**: Organization ID is incorrect or missing  
+**Fix**: Double-check your Organization ID in Zoho Desk Setup → Developer Space → API
+
+### "Insufficient scope" or 401 Unauthorized
+
+**Cause**: OAuth app doesn't have required scopes  
+**Fix**: Update the **Scope** field in your credential to include the necessary permissions (e.g., add `Desk.tasks.ALL` if you need task access)
+
+### Token refresh not happening automatically
+
+**Cause**: Using `httpRequest` instead of `requestOAuth2`  
+**Fix**: This should not happen with this node - it's built to use `requestOAuth2`. If you see this, please file an issue.
+
+### "Department ID not found" when creating tickets
+
+**Cause**: Invalid department ID  
+**Fix**: Get valid department IDs from Zoho Desk Setup → Channels & Departments, or use the Zoho Desk API to list departments
+
+## 📚 API Documentation
+
+- [Zoho Desk API Reference](https://desk.zoho.com/DeskAPIDocument)
+- [Zoho OAuth 2.0 Guide](https://www.zoho.com/accounts/protocol/oauth.html)
+- [n8n Community Nodes Documentation](https://docs.n8n.io/integrations/creating-nodes/)
+
+## 🛠️ Development
+
+### Build
+
+```bash
+npm run build
+```
+
+### Type Check
+
+```bash
+npm run typecheck
+```
+
+### Validate
+
+```bash
+npm test
+```
+
+## 📝 Publishing to npm
+
+1. Update `package.json`:
+  - Bump `version`
+  - Update `name` if needed (must be unique on npm)
+  - Verify `description`, `author`, `keywords`
+
+2. Build and test:
+  ```bash
+  npm run typecheck
+  npm run build
+  npm test
+  ```
+
+3. Publish:
+  ```bash
+  npm login
+  npm publish
+  ```
+
+## 📄 License
+
+MIT
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit issues or pull requests.
+
+## 🙏 Credits
+
+Built following n8n's community node patterns and inspired by the official Zoho CRM node implementation.
+
+```bash
+npm login
+npm whoami
+```
+
+If your org uses 2FA, npm will ask for OTP during publish.
+
+### 4) Publish
+
+```bash
+npm publish
+```
+
+For updates, bump version first:
+
+```bash
+npm version patch
+npm publish
+```
+
+### 5) Install in n8n
+
+On your n8n host:
+
+```bash
+npm install n8n-nodes-zoho-desk
+```
+
+Then restart n8n. The new node should appear in the editor.
+
+### 6) Configure credentials in n8n
+
+In n8n UI:
+1. Create credentials using **Zoho OAuth2 API**.
+2. Add `Zoho Desk` node to a workflow.
+3. Set `Data Center` and `Organization ID`.
+4. Run ticket operations.
+
+## Troubleshooting npm publish
+
+- **`403 Forbidden` when publishing**: package name already exists or account lacks rights; change name or publish under the correct npm org/scope.
+- **`402 Payment Required`**: scoped package defaults to private; use `--access public` or keep `publishConfig.access = public`.
+- **Missing files after install**: confirm `files` in `package.json` includes your built `dist` output and rerun `npm pack`.

package/dist/credentials/ZohoCRMDeskOAuth2Api.credentials.d.ts

@@ -0,0 +1,8 @@
+import type { ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class ZohoCRMDeskOAuth2Api implements ICredentialType {
+    name: string;
+    extends: string[];
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+}

package/dist/credentials/ZohoCRMDeskOAuth2Api.credentials.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZohoCRMDeskOAuth2Api = void 0;
+class ZohoCRMDeskOAuth2Api {
+    constructor() {
+        this.name = 'zohoCRMDeskOAuth2Api';
+        this.extends = ['oAuth2Api'];
+        this.displayName = 'Zoho CRM & Desk OAuth2 API';
+        this.documentationUrl = 'https://www.zoho.com/desk/developer-guide/';
+        this.properties = [
+            {
+                displayName: 'Grant Type',
+                name: 'grantType',
+                type: 'hidden',
+                default: 'authorizationCode',
+            },
+            {
+                displayName: 'Authorization URL',
+                name: 'authUrl',
+                type: 'options',
+                options: [
+                    {
+                        name: 'https://accounts.zoho.com/oauth/v2/auth',
+                        value: 'https://accounts.zoho.com/oauth/v2/auth',
+                        description: 'For US, EU, AU, and IN domains',
+                    },
+                    {
+                        name: 'https://accounts.zoho.com.cn/oauth/v2/auth',
+                        value: 'https://accounts.zoho.com.cn/oauth/v2/auth',
+                        description: 'For China domain',
+                    },
+                ],
+                default: 'https://accounts.zoho.com/oauth/v2/auth',
+                required: true,
+            },
+            {
+                displayName: 'Access Token URL',
+                name: 'accessTokenUrl',
+                type: 'options',
+                options: [
+                    {
+                        name: 'US - https://accounts.zoho.com/oauth/v2/token',
+                        value: 'https://accounts.zoho.com/oauth/v2/token',
+                    },
+                    {
+                        name: 'EU - https://accounts.zoho.eu/oauth/v2/token',
+                        value: 'https://accounts.zoho.eu/oauth/v2/token',
+                    },
+                    {
+                        name: 'IN - https://accounts.zoho.in/oauth/v2/token',
+                        value: 'https://accounts.zoho.in/oauth/v2/token',
+                    },
+                    {
+                        name: 'AU - https://accounts.zoho.com.au/oauth/v2/token',
+                        value: 'https://accounts.zoho.com.au/oauth/v2/token',
+                    },
+                    {
+                        name: 'CN - https://accounts.zoho.com.cn/oauth/v2/token',
+                        value: 'https://accounts.zoho.com.cn/oauth/v2/token',
+                    },
+                ],
+                default: 'https://accounts.zoho.com/oauth/v2/token',
+                required: true,
+            },
+            {
+                displayName: 'Scope',
+                name: 'scope',
+                type: 'string',
+                default: 'ZohoCRM.modules.ALL Desk.tickets.ALL Desk.contacts.ALL Desk.search.READ',
+                required: true,
+                description: 'Space-separated OAuth scopes. Default includes both CRM and Desk permissions. Add or remove scopes as needed (e.g., Desk.settings.ALL, Desk.tasks.ALL).',
+            },
+            {
+                displayName: 'Auth URI Query Parameters',
+                name: 'authQueryParameters',
+                type: 'hidden',
+                default: 'access_type=offline',
+                description: 'Requests offline access with refresh token for automatic token renewal',
+            },
+            {
+                displayName: 'Authentication',
+                name: 'authentication',
+                type: 'hidden',
+                default: 'body',
+                description: 'Zoho requires client credentials in request body',
+            },
+        ];
+    }
+}
+exports.ZohoCRMDeskOAuth2Api = ZohoCRMDeskOAuth2Api;

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './nodes/ZohoDesk/ZohoDesk.node';
+export * from './credentials/ZohoCRMDeskOAuth2Api.credentials';

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./nodes/ZohoDesk/ZohoDesk.node"), exports);
+__exportStar(require("./credentials/ZohoCRMDeskOAuth2Api.credentials"), exports);

package/dist/nodes/ZohoDesk/GenericFunctions.d.ts

@@ -0,0 +1,6 @@
+import type { IExecuteFunctions, ILoadOptionsFunctions, IHttpRequestMethods, IDataObject } from 'n8n-workflow';
+export declare function zohoDeskApiRequest(this: IExecuteFunctions | ILoadOptionsFunctions, method: IHttpRequestMethods, endpoint: string, body?: IDataObject, qs?: IDataObject, itemIndex?: number): Promise<any>;
+/**
+ * Make an API request to paginate through all items
+ */
+export declare function zohoDeskApiRequestAllItems(this: IExecuteFunctions | ILoadOptionsFunctions, method: IHttpRequestMethods, endpoint: string, body?: IDataObject, qs?: IDataObject, itemIndex?: number): Promise<any>;

package/dist/nodes/ZohoDesk/GenericFunctions.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zohoDeskApiRequest = zohoDeskApiRequest;
+exports.zohoDeskApiRequestAllItems = zohoDeskApiRequestAllItems;
+const n8n_workflow_1 = require("n8n-workflow");
+async function zohoDeskApiRequest(method, endpoint, body = {}, qs = {}, itemIndex = 0) {
+    // Get credentials with OAuth token data containing regional API domain
+    const credentials = (await this.getCredentials('zohoCRMDeskOAuth2Api'));
+    const { oauthTokenData } = credentials;
+    // Get organization ID from node parameters
+    const organizationId = this.getNodeParameter('organizationId', itemIndex);
+    // Build request options
+    const options = {
+        method,
+        qs,
+        body,
+        uri: `${oauthTokenData.api_domain}/api/v1${endpoint}`,
+        headers: {
+            orgId: organizationId,
+            'Content-Type': 'application/json',
+        },
+        json: true,
+    };
+    // Clean up empty parameters
+    if (!Object.keys(body).length) {
+        delete options.body;
+    }
+    if (!Object.keys(qs).length) {
+        delete options.qs;
+    }
+    try {
+        // Use requestOAuth2 for automatic token refresh handling
+        const responseData = await this.helpers.requestOAuth2?.call(this, 'zohoCRMDeskOAuth2Api', options);
+        if (responseData === undefined) {
+            return [];
+        }
+        return responseData;
+    }
+    catch (error) {
+        throw new n8n_workflow_1.NodeApiError(this.getNode(), error);
+    }
+}
+/**
+ * Make an API request to paginate through all items
+ */
+async function zohoDeskApiRequestAllItems(method, endpoint, body = {}, qs = {}, itemIndex = 0) {
+    const returnData = [];
+    let responseData;
+    qs.limit = 100; // Zoho Desk max limit per page
+    qs.from = 0;
+    do {
+        responseData = await zohoDeskApiRequest.call(this, method, endpoint, body, qs, itemIndex);
+        if (responseData.data && Array.isArray(responseData.data)) {
+            returnData.push(...responseData.data);
+            if (responseData.data.length < 100) {
+                // Last page
+                break;
+            }
+            qs.from = qs.from + 100;
+        }
+        else {
+            break;
+        }
+    } while (true);
+    return returnData;
+}

package/dist/nodes/ZohoDesk/ZohoDesk.node.d.ts

@@ -0,0 +1,5 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class ZohoDesk implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/ZohoDesk/ZohoDesk.node.js

@@ -0,0 +1,516 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZohoDesk = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const GenericFunctions_1 = require("./GenericFunctions");
+class ZohoDesk {
+    constructor() {
+        this.description = {
+            displayName: 'Zoho Desk',
+            name: 'zohoDesk',
+            icon: 'file:zohodesk.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+            description: 'Zoho Desk starter node using n8n built-in zohoOAuth2Api credential for automatic refresh-token handling',
+            defaults: {
+                name: 'Zoho Desk',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [
+                {
+                    name: 'zohoCRMDeskOAuth2Api',
+                    required: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Organization ID',
+                    name: 'organizationId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    description: 'Your Zoho Desk Organization ID. Find this in Setup > Developer Space > API.',
+                },
+                {
+                    displayName: 'Resource',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    default: 'ticket',
+                    options: [
+                        { name: 'Ticket', value: 'ticket' },
+                        { name: 'Contact', value: 'contact' },
+                        { name: 'Comment', value: 'comment' },
+                    ],
+                },
+                // Ticket Operations
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: { show: { resource: ['ticket'] } },
+                    default: 'get',
+                    options: [
+                        { name: 'Create', value: 'create', action: 'Create a ticket' },
+                        { name: 'Get', value: 'get', action: 'Get a ticket' },
+                        { name: 'Get Many', value: 'getAll', action: 'Get many tickets' },
+                        { name: 'Update', value: 'update', action: 'Update a ticket' },
+                    ],
+                },
+                // Contact Operations
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: { show: { resource: ['contact'] } },
+                    default: 'get',
+                    options: [
+                        { name: 'Create', value: 'create', action: 'Create a contact' },
+                        { name: 'Get', value: 'get', action: 'Get a contact' },
+                        { name: 'Get Many', value: 'getAll', action: 'Get many contacts' },
+                        { name: 'Search', value: 'search', action: 'Search contacts' },
+                        { name: 'Update', value: 'update', action: 'Update a contact' },
+                    ],
+                },
+                // Comment Operations
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: { show: { resource: ['comment'] } },
+                    default: 'add',
+                    options: [
+                        { name: 'Add', value: 'add', action: 'Add a comment to ticket' },
+                        { name: 'Get Many', value: 'getAll', action: 'Get all comments from ticket' },
+                    ],
+                },
+                // ================== Ticket Resource Parameters ==================
+                {
+                    displayName: 'Ticket ID',
+                    name: 'ticketId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: { show: { resource: ['ticket'], operation: ['get', 'update'] } },
+                    description: 'The unique ID of the ticket',
+                },
+                {
+                    displayName: 'Subject',
+                    name: 'subject',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: { show: { resource: ['ticket'], operation: ['create'] } },
+                    description: 'Subject/title of the ticket',
+                },
+                {
+                    displayName: 'Contact Email',
+                    name: 'email',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: { show: { resource: ['ticket'], operation: ['create'] } },
+                    description: 'Email address of the contact creating this ticket',
+                },
+                {
+                    displayName: 'Department ID',
+                    name: 'departmentId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: { show: { resource: ['ticket'], operation: ['create'] } },
+                    description: 'ID of the department to assign the ticket',
+                },
+                {
+                    displayName: 'Description',
+                    name: 'description',
+                    type: 'string',
+                    typeOptions: { alwaysOpenEditWindow: true },
+                    default: '',
+                    displayOptions: { show: { resource: ['ticket'], operation: ['create', 'update'] } },
+                    description: 'Description/content of the ticket',
+                },
+                {
+                    displayName: 'Additional Fields',
+                    name: 'additionalFields',
+                    type: 'collection',
+                    placeholder: 'Add Field',
+                    default: {},
+                    displayOptions: { show: { resource: ['ticket'], operation: ['create', 'update'] } },
+                    options: [
+                        {
+                            displayName: 'Assignee ID',
+                            name: 'assigneeId',
+                            type: 'string',
+                            default: '',
+                            description: 'Agent ID to assign the ticket to',
+                        },
+                        {
+                            displayName: 'Contact ID',
+                            name: 'contactId',
+                            type: 'string',
+                            default: '',
+                            description: 'ID of existing contact (alternative to email)',
+                        },
+                        {
+                            displayName: 'Due Date',
+                            name: 'dueDate',
+                            type: 'dateTime',
+                            default: '',
+                            description: 'Due date for the ticket (ISO 8601 format)',
+                        },
+                        {
+                            displayName: 'Priority',
+                            name: 'priority',
+                            type: 'options',
+                            options: [
+                                { name: 'High', value: 'High' },
+                                { name: 'Medium', value: 'Medium' },
+                                { name: 'Low', value: 'Low' },
+                            ],
+                            default: 'Medium',
+                            description: 'Priority level of the ticket',
+                        },
+                        {
+                            displayName: 'Status',
+                            name: 'status',
+                            type: 'string',
+                            default: '',
+                            description: 'Status of the ticket (e.g., Open, In Progress, Closed)',
+                        },
+                    ],
+                },
+                {
+                    displayName: 'Limit',
+                    name: 'limit',
+                    type: 'number',
+                    typeOptions: { minValue: 1, maxValue: 100 },
+                    default: 20,
+                    displayOptions: { show: { resource: ['ticket'], operation: ['getAll'] } },
+                    description: 'Max number of results to return',
+                },
+                {
+                    displayName: 'Return All',
+                    name: 'returnAll',
+                    type: 'boolean',
+                    default: false,
+                    displayOptions: { show: { resource: ['ticket'], operation: ['getAll'] } },
+                    description: 'Whether to return all results or limit to specified number',
+                },
+                // ================== Contact Resource Parameters ==================
+                {
+                    displayName: 'Contact ID',
+                    name: 'contactId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: { show: { resource: ['contact'], operation: ['get', 'update'] } },
+                    description: 'The unique ID of the contact',
+                },
+                {
+                    displayName: 'Last Name',
+                    name: 'lastName',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: { show: { resource: ['contact'], operation: ['create'] } },
+                    description: 'Last name of the contact',
+                },
+                {
+                    displayName: 'Email',
+                    name: 'email',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: { show: { resource: ['contact'], operation: ['create'] } },
+                    description: 'Email address of the contact',
+                },
+                {
+                    displayName: 'Additional Fields',
+                    name: 'additionalFields',
+                    type: 'collection',
+                    placeholder: 'Add Field',
+                    default: {},
+                    displayOptions: { show: { resource: ['contact'], operation: ['create', 'update'] } },
+                    options: [
+                        {
+                            displayName: 'First Name',
+                            name: 'firstName',
+                            type: 'string',
+                            default: '',
+                            description: 'First name of the contact',
+                        },
+                        {
+                            displayName: 'Phone',
+                            name: 'phone',
+                            type: 'string',
+                            default: '',
+                            description: 'Phone number of the contact',
+                        },
+                        {
+                            displayName: 'Mobile',
+                            name: 'mobile',
+                            type: 'string',
+                            default: '',
+                            description: 'Mobile number of the contact',
+                        },
+                        {
+                            displayName: 'Account ID',
+                            name: 'accountId',
+                            type: 'string',
+                            default: '',
+                            description: 'ID of the account to associate with',
+                        },
+                        {
+                            displayName: 'Description',
+                            name: 'description',
+                            type: 'string',
+                            default: '',
+                            description: 'Additional description about the contact',
+                        },
+                    ],
+                },
+                {
+                    displayName: 'Search Query',
+                    name: 'searchQuery',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: { show: { resource: ['contact'], operation: ['search'] } },
+                    description: 'Search query string (e.g., email, name, phone)',
+                },
+                {
+                    displayName: 'Limit',
+                    name: 'limit',
+                    type: 'number',
+                    typeOptions: { minValue: 1, maxValue: 100 },
+                    default: 20,
+                    displayOptions: { show: { resource: ['contact'], operation: ['getAll', 'search'] } },
+                    description: 'Max number of results to return',
+                },
+                {
+                    displayName: 'Return All',
+                    name: 'returnAll',
+                    type: 'boolean',
+                    default: false,
+                    displayOptions: { show: { resource: ['contact'], operation: ['getAll'] } },
+                    description: 'Whether to return all results or limit to specified number',
+                },
+                // ================== Comment Resource Parameters ==================
+                {
+                    displayName: 'Ticket ID',
+                    name: 'ticketId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: { show: { resource: ['comment'], operation: ['add', 'getAll'] } },
+                    description: 'ID of the ticket to add comment to or get comments from',
+                },
+                {
+                    displayName: 'Content',
+                    name: 'content',
+                    type: 'string',
+                    typeOptions: { alwaysOpenEditWindow: true },
+                    default: '',
+                    required: true,
+                    displayOptions: { show: { resource: ['comment'], operation: ['add'] } },
+                    description: 'Content of the comment',
+                },
+                {
+                    displayName: 'Is Public',
+                    name: 'isPublic',
+                    type: 'boolean',
+                    default: true,
+                    displayOptions: { show: { resource: ['comment'], operation: ['add'] } },
+                    description: 'Whether the comment is public (visible to customer) or private (internal note)',
+                },
+                {
+                    displayName: 'Content Type',
+                    name: 'contentType',
+                    type: 'options',
+                    options: [
+                        { name: 'Plain Text', value: 'plainText' },
+                        { name: 'HTML', value: 'html' },
+                    ],
+                    default: 'plainText',
+                    displayOptions: { show: { resource: ['comment'], operation: ['add'] } },
+                    description: 'Format of the comment content',
+                },
+                {
+                    displayName: 'Limit',
+                    name: 'limit',
+                    type: 'number',
+                    typeOptions: { minValue: 1, maxValue: 100 },
+                    default: 20,
+                    displayOptions: { show: { resource: ['comment'], operation: ['getAll'] } },
+                    description: 'Max number of results to return',
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        for (let i = 0; i < items.length; i++) {
+            const resource = this.getNodeParameter('resource', i);
+            const operation = this.getNodeParameter('operation', i);
+            try {
+                // ==================== TICKET OPERATIONS ====================
+                if (resource === 'ticket') {
+                    if (operation === 'get') {
+                        const ticketId = this.getNodeParameter('ticketId', i);
+                        const responseData = await GenericFunctions_1.zohoDeskApiRequest.call(this, 'GET', `/tickets/${ticketId}`, {}, {}, i);
+                        returnData.push({ json: responseData });
+                    }
+                    if (operation === 'getAll') {
+                        const returnAll = this.getNodeParameter('returnAll', i, false);
+                        if (returnAll) {
+                            const responseData = await GenericFunctions_1.zohoDeskApiRequestAllItems.call(this, 'GET', '/tickets', {}, {}, i);
+                            for (const row of responseData) {
+                                returnData.push({ json: row });
+                            }
+                        }
+                        else {
+                            const limit = this.getNodeParameter('limit', i);
+                            const responseData = await GenericFunctions_1.zohoDeskApiRequest.call(this, 'GET', '/tickets', {}, { limit }, i);
+                            const data = Array.isArray(responseData.data)
+                                ? responseData.data
+                                : [responseData];
+                            for (const row of data) {
+                                returnData.push({ json: row });
+                            }
+                        }
+                    }
+                    if (operation === 'create') {
+                        const subject = this.getNodeParameter('subject', i);
+                        const email = this.getNodeParameter('email', i);
+                        const departmentId = this.getNodeParameter('departmentId', i);
+                        const description = this.getNodeParameter('description', i, '');
+                        const additionalFields = this.getNodeParameter('additionalFields', i, {});
+                        const body = {
+                            subject,
+                            email,
+                            departmentId,
+                            ...additionalFields,
+                        };
+                        if (description) {
+                            body.description = description;
+                        }
+                        const responseData = await GenericFunctions_1.zohoDeskApiRequest.call(this, 'POST', '/tickets', body, {}, i);
+                        returnData.push({ json: responseData });
+                    }
+                    if (operation === 'update') {
+                        const ticketId = this.getNodeParameter('ticketId', i);
+                        const description = this.getNodeParameter('description', i, '');
+                        const additionalFields = this.getNodeParameter('additionalFields', i, {});
+                        const body = {
+                            ...additionalFields,
+                        };
+                        if (description) {
+                            body.description = description;
+                        }
+                        const responseData = await GenericFunctions_1.zohoDeskApiRequest.call(this, 'PATCH', `/tickets/${ticketId}`, body, {}, i);
+                        returnData.push({ json: responseData });
+                    }
+                }
+                // ==================== CONTACT OPERATIONS ====================
+                if (resource === 'contact') {
+                    if (operation === 'get') {
+                        const contactId = this.getNodeParameter('contactId', i);
+                        const responseData = await GenericFunctions_1.zohoDeskApiRequest.call(this, 'GET', `/contacts/${contactId}`, {}, {}, i);
+                        returnData.push({ json: responseData });
+                    }
+                    if (operation === 'getAll') {
+                        const returnAll = this.getNodeParameter('returnAll', i, false);
+                        if (returnAll) {
+                            const responseData = await GenericFunctions_1.zohoDeskApiRequestAllItems.call(this, 'GET', '/contacts', {}, {}, i);
+                            for (const row of responseData) {
+                                returnData.push({ json: row });
+                            }
+                        }
+                        else {
+                            const limit = this.getNodeParameter('limit', i);
+                            const responseData = await GenericFunctions_1.zohoDeskApiRequest.call(this, 'GET', '/contacts', {}, { limit }, i);
+                            const data = Array.isArray(responseData.data)
+                                ? responseData.data
+                                : [responseData];
+                            for (const row of data) {
+                                returnData.push({ json: row });
+                            }
+                        }
+                    }
+                    if (operation === 'create') {
+                        const lastName = this.getNodeParameter('lastName', i);
+                        const email = this.getNodeParameter('email', i);
+                        const additionalFields = this.getNodeParameter('additionalFields', i, {});
+                        const body = {
+                            lastName,
+                            email,
+                            ...additionalFields,
+                        };
+                        const responseData = await GenericFunctions_1.zohoDeskApiRequest.call(this, 'POST', '/contacts', body, {}, i);
+                        returnData.push({ json: responseData });
+                    }
+                    if (operation === 'update') {
+                        const contactId = this.getNodeParameter('contactId', i);
+                        const additionalFields = this.getNodeParameter('additionalFields', i, {});
+                        const responseData = await GenericFunctions_1.zohoDeskApiRequest.call(this, 'PATCH', `/contacts/${contactId}`, additionalFields, {}, i);
+                        returnData.push({ json: responseData });
+                    }
+                    if (operation === 'search') {
+                        const searchQuery = this.getNodeParameter('searchQuery', i);
+                        const limit = this.getNodeParameter('limit', i);
+                        const responseData = await GenericFunctions_1.zohoDeskApiRequest.call(this, 'GET', '/contacts/search', {}, { limit, searchStr: searchQuery }, i);
+                        const data = Array.isArray(responseData.data)
+                            ? responseData.data
+                            : [responseData];
+                        for (const row of data) {
+                            returnData.push({ json: row });
+                        }
+                    }
+                }
+                // ==================== COMMENT OPERATIONS ====================
+                if (resource === 'comment') {
+                    if (operation === 'add') {
+                        const ticketId = this.getNodeParameter('ticketId', i);
+                        const content = this.getNodeParameter('content', i);
+                        const isPublic = this.getNodeParameter('isPublic', i);
+                        const contentType = this.getNodeParameter('contentType', i);
+                        const body = {
+                            content,
+                            isPublic,
+                            contentType,
+                        };
+                        const responseData = await GenericFunctions_1.zohoDeskApiRequest.call(this, 'POST', `/tickets/${ticketId}/comments`, body, {}, i);
+                        returnData.push({ json: responseData });
+                    }
+                    if (operation === 'getAll') {
+                        const ticketId = this.getNodeParameter('ticketId', i);
+                        const limit = this.getNodeParameter('limit', i);
+                        const responseData = await GenericFunctions_1.zohoDeskApiRequest.call(this, 'GET', `/tickets/${ticketId}/comments`, {}, { limit }, i);
+                        const data = Array.isArray(responseData.data)
+                            ? responseData.data
+                            : [responseData];
+                        for (const row of data) {
+                            returnData.push({ json: row });
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({ json: { error: error.message }, pairedItem: i });
+                    continue;
+                }
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), error, { itemIndex: i });
+            }
+        }
+        return [returnData];
+    }
+}
+exports.ZohoDesk = ZohoDesk;

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@trg-admin/n8n-nodes-zoho-desk",
+  "version": "0.1.0",
+  "description": "Community n8n node starter for Zoho Desk using built-in Zoho OAuth2 auth behavior",
+  "license": "MIT",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "lint": "echo 'No linter configured'",
+    "typecheck": "tsc --noEmit",
+    "test": "node scripts.validate.js",
+    "prepublishOnly": "npm run typecheck && npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "nodes": [
+      "dist/nodes/ZohoDesk/ZohoDesk.node.js"
+    ],
+    "credentials": [
+      "dist/credentials/ZohoCRMDeskOAuth2Api.credentials.js"
+    ]
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}