n8n-nodes-zoho-desk 1.0.0

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

@@ -0,0 +1,2534 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZohoDesk = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+/**
+ * Optional fields for ticket create operation
+ * Note: Some fields like 'secondaryContacts' and 'cf'
+ * are handled separately with custom parsing logic (see addCommonTicketFields function)
+ * Note: 'priority', 'classification', 'dueDate', 'description', and 'teamId' are primary fields for create operation
+ */
+const TICKET_CREATE_OPTIONAL_FIELDS = [
+    'accountId',
+    'assigneeId',
+    'category',
+    'channel',
+    'email',
+    'language',
+    'phone',
+    'productId',
+    'resolution',
+    'status',
+    'subCategory',
+];
+/**
+ * Optional fields for ticket update operation
+ * Note: Some fields like 'dueDate', 'priority', 'secondaryContacts', and 'cf'
+ * are handled separately with custom parsing logic (see addCommonTicketFields function)
+ * Note: 'description' is now a primary field for update operation
+ * Note: 'channel' is not updatable - it represents how the ticket was originally created
+ * Note: 'classification' is now handled as an options field with "No Change" option
+ */
+const TICKET_UPDATE_OPTIONAL_FIELDS = [
+    'accountId',
+    'assigneeId',
+    'category',
+    'contactId',
+    'departmentId',
+    'email',
+    'language',
+    'phone',
+    'productId',
+    'resolution',
+    'status',
+    'subCategory',
+    'subject',
+    'teamId',
+];
+/**
+ * Minimum number of digits for a valid Zoho Desk ticket ID
+ * Zoho Desk ticket IDs are typically 16-19 digits, but we allow 10+ for flexibility
+ * across different Zoho configurations and data centers
+ */
+const MIN_TICKET_ID_LENGTH = 10;
+/**
+ * Default status for new tickets
+ */
+const DEFAULT_TICKET_STATUS = 'Open';
+/**
+ * Zoho Desk API version
+ */
+const ZOHO_DESK_API_VERSION = 'v1';
+/**
+ * Default base URL for Zoho Desk API
+ */
+const DEFAULT_BASE_URL = `https://desk.zoho.com/api/${ZOHO_DESK_API_VERSION}`;
+/**
+ * Field length limits with documented standards.
+ *
+ * IMPORTANT: Only includes limits that are based on official standards or would cause
+ * system issues if exceeded. For fields without documented limits, we rely on the
+ * Zoho Desk API to return validation errors.
+ *
+ * This approach prevents false rejections of valid user input while still providing
+ * protection for fields with known constraints.
+ */
+const FIELD_LENGTH_LIMITS = {
+    email: 254, // RFC 5321 maximum email length - official standard
+};
+/**
+ * Pre-compiled regex patterns for performance optimization
+ */
+const N8N_EXPRESSION_PATTERN = /\{\{.+?\}\}/;
+const RFC5322_EMAIL_PATTERN = /^[a-zA-Z0-9.!#$%&'*+\/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;
+const ZOHO_DESK_ID_PATTERN = /^\d{10,}$/;
+const TICKET_ID_PATTERN = new RegExp(`^\\d{${MIN_TICKET_ID_LENGTH},}$`);
+/**
+ * Zoho Desk API documentation URLs
+ */
+const ZOHO_DESK_CREATE_TICKET_DOCS = 'https://desk.zoho.com/support/APIDocument#Tickets#Tickets_CreateTicket';
+const ZOHO_DESK_UPDATE_TICKET_DOCS = 'https://desk.zoho.com/support/APIDocument#Tickets#Tickets_UpdateTicket';
+const ZOHO_DESK_GET_TICKET_DOCS = 'https://desk.zoho.com/support/APIDocument#Tickets#Tickets_GetTicket';
+const ZOHO_DESK_LIST_TICKETS_DOCS = 'https://desk.zoho.com/support/APIDocument#Tickets#Tickets_ListAllTickets';
+const ZOHO_DESK_COMMENTS_DOCS = 'https://desk.zoho.com/support/APIDocument#TicketComments';
+const ZOHO_DESK_THREADS_DOCS = 'https://desk.zoho.com/support/APIDocument#TicketThreads';
+const ZOHO_DESK_CONTACTS_DOCS = 'https://desk.zoho.com/support/APIDocument#Contacts';
+const ZOHO_DESK_ACCOUNTS_DOCS = 'https://desk.zoho.com/support/APIDocument#Accounts';
+/**
+ * Optional fields for contact create operation
+ */
+const CONTACT_CREATE_OPTIONAL_FIELDS = [
+    'firstName',
+    'phone',
+    'mobile',
+    'accountId',
+    'twitter',
+    'facebook',
+    'type',
+    'description',
+];
+/**
+ * Optional fields for contact update operation
+ */
+const CONTACT_UPDATE_OPTIONAL_FIELDS = [
+    'firstName',
+    'lastName',
+    'email',
+    'phone',
+    'mobile',
+    'accountId',
+    'twitter',
+    'facebook',
+    'type',
+    'description',
+];
+/**
+ * Optional fields for account create operation
+ */
+const ACCOUNT_CREATE_OPTIONAL_FIELDS = [
+    'website',
+    'phone',
+    'fax',
+    'industry',
+    'description',
+    'code',
+    'city',
+    'country',
+    'state',
+    'street',
+    'zip',
+];
+/**
+ * Optional fields for account update operation
+ */
+const ACCOUNT_UPDATE_OPTIONAL_FIELDS = [
+    'accountName',
+    'website',
+    'phone',
+    'fax',
+    'industry',
+    'description',
+    'code',
+    'city',
+    'country',
+    'state',
+    'street',
+    'zip',
+];
+/**
+ * Type guard to check if value is a plain object (not array or null)
+ * @param value - Value to check
+ * @returns True if value is a plain object
+ */
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Parse comma-separated list and filter out empty values
+ * @param value - Comma-separated string (can be undefined)
+ * @returns Array of trimmed non-empty values
+ */
+function parseCommaSeparatedList(value) {
+    if (!value) {
+        return [];
+    }
+    return value
+        .split(',')
+        .map((item) => item.trim())
+        .filter((item) => item.length > 0);
+}
+/**
+ * Parse custom fields JSON with enhanced error handling, type validation, and CRLF removal
+ * @param cf - Custom fields as JSON string or object
+ * @returns Parsed and sanitized custom fields object
+ * @throws Error with detailed message if JSON parsing fails or result is not a plain object
+ */
+function parseCustomFields(cf) {
+    try {
+        let parsed;
+        if (typeof cf === 'string') {
+            parsed = JSON.parse(cf);
+        }
+        else {
+            parsed = cf;
+        }
+        // Validate that parsed result is a plain object (not array or primitive)
+        if (!isPlainObject(parsed)) {
+            throw new n8n_workflow_1.ApplicationError('Custom fields must be a JSON object, not an array or primitive value. ' +
+                'See: ' +
+                ZOHO_DESK_CREATE_TICKET_DOCS);
+        }
+        // Sanitize all string values in custom fields to remove CRLF characters
+        const sanitized = {};
+        for (const [key, value] of Object.entries(parsed)) {
+            if (typeof value === 'string') {
+                // Validate length for custom field values (no length limit specified)
+                sanitized[key] = validateFieldLength(value, undefined, `Custom field "${key}"`);
+            }
+            else if (value !== null && value !== undefined) {
+                // Keep non-string, non-null values as-is
+                sanitized[key] = value;
+            }
+        }
+        return sanitized;
+    }
+    catch (error) {
+        // Check if error is already a validation error from isPlainObject check or validateFieldLength
+        if (error instanceof Error &&
+            (error.message.includes('Custom fields must be a JSON object') ||
+                error.message.includes('exceeds maximum length'))) {
+            // Re-throw validation errors without wrapping to preserve specific details
+            throw error;
+        }
+        // Wrap JSON parsing errors with helpful context
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new n8n_workflow_1.ApplicationError(`Custom fields must be valid JSON. Parse error: ${errorMessage}. ` +
+            `Please ensure your JSON is properly formatted, e.g., {"cf_field": "value"}. ` +
+            'See: ' +
+            ZOHO_DESK_CREATE_TICKET_DOCS);
+    }
+}
+/**
+ * Add optional fields to request body if they exist in source object
+ * Removes CRLF characters from string fields to prevent header injection
+ * @param body - Target object to add fields to
+ * @param source - Source object containing field values
+ * @param fields - Array of field names to copy
+ */
+function addOptionalFields(body, source, fields) {
+    for (const field of fields) {
+        if (source[field] !== undefined) {
+            // Validate length for string fields (XSS protection handled by Zoho Desk API)
+            if (typeof source[field] === 'string') {
+                const stringValue = source[field];
+                // Capitalize field name once for all uses (avoid variable shadowing)
+                const fieldDisplayName = field.charAt(0).toUpperCase() + field.slice(1);
+                // Validate ID fields - empty strings are allowed (Zoho Desk API will ignore them)
+                if (field.endsWith('Id') && stringValue.trim() !== '') {
+                    isValidZohoDeskId(stringValue, fieldDisplayName);
+                }
+                // Apply length limits from FIELD_LENGTH_LIMITS or use undefined for no limit
+                const maxLength = field in FIELD_LENGTH_LIMITS
+                    ? FIELD_LENGTH_LIMITS[field]
+                    : undefined;
+                body[field] = validateFieldLength(stringValue, maxLength, fieldDisplayName);
+            }
+            else {
+                body[field] = source[field];
+            }
+        }
+    }
+}
+/**
+ * Validate ticket ID format
+ * @param ticketId - Ticket ID to validate
+ * @returns True if ticket ID is valid (numeric with proper length or n8n expression), false otherwise
+ */
+function isValidTicketId(ticketId) {
+    const trimmed = ticketId.trim();
+    // Allow n8n expressions (e.g., {{$json.ticketId}}) - validation happens at runtime
+    // Use pre-compiled pattern for performance
+    if (N8N_EXPRESSION_PATTERN.test(trimmed)) {
+        return true;
+    }
+    // Zoho Desk ticket IDs are typically 16-19 digit numeric strings
+    // Use pre-compiled pattern for performance
+    return TICKET_ID_PATTERN.test(trimmed);
+}
+/**
+ * Validate generic Zoho Desk ID format (for accounts, departments, teams, etc.)
+ * @param id - ID to validate
+ * @param fieldName - Field name for error messages
+ * @returns True if ID is valid (numeric or n8n expression), false otherwise
+ */
+function isValidZohoDeskId(id, fieldName) {
+    const trimmed = id.trim();
+    // Allow n8n expressions - validation happens at runtime
+    // Use pre-compiled pattern for performance
+    if (N8N_EXPRESSION_PATTERN.test(trimmed)) {
+        return true;
+    }
+    // Zoho Desk IDs are numeric strings (minimum 10 digits for safety)
+    // Less strict than ticket IDs as different resources may have different lengths
+    // Use pre-compiled pattern for performance
+    if (!ZOHO_DESK_ID_PATTERN.test(trimmed)) {
+        throw new n8n_workflow_1.ApplicationError(`Invalid ${fieldName} format: "${trimmed}". ` +
+            `${fieldName} must be a numeric value with at least 10 digits.`);
+    }
+    return true;
+}
+/**
+ * Validate field length without modifying content
+ *
+ * IMPORTANT: Does NOT sanitize CRLF characters because:
+ * - This node sends JSON request bodies, not HTTP headers
+ * - CRLF injection only affects HTTP headers (e.g., "Header: value\r\nInjected-Header: malicious")
+ * - In JSON bodies, newlines are safe and expected (e.g., multi-line descriptions)
+ * - JSON serialization automatically escapes newlines as \n in the wire format
+ * - Removing newlines breaks user-expected behavior for description and custom fields
+ *
+ * Example: "Line 1\nLine 2\nLine 3" → sent as-is → JSON serializes to "Line 1\\nLine 2\\nLine 3"
+ *
+ * SECURITY NOTE: Does NOT protect against XSS - handled by Zoho Desk API server-side.
+ * Input like '<script>alert(XSS)</script>' passes through unchanged (as expected).
+ *
+ * @param value - String value to validate
+ * @param maxLength - Maximum allowed length (optional). Throws error if exceeded.
+ * @param fieldName - Field name for error messages (optional, defaults to 'Field')
+ * @returns Original string value unchanged (preserves newlines and formatting)
+ * @throws Error if value exceeds maxLength
+ */
+function validateFieldLength(value, maxLength, fieldName) {
+    // Enforce length limit if specified - THROW ERROR instead of silent truncation
+    if (maxLength && value.length > maxLength) {
+        throw new n8n_workflow_1.ApplicationError(`${fieldName || 'Field'} exceeds maximum length of ${maxLength} characters (${value.length} provided). ` +
+            'Please shorten your input and try again.');
+    }
+    return value;
+}
+/**
+ * Validate and normalize ISO 8601 date string for Zoho Desk API
+ *
+ * @param dateString - ISO 8601 formatted date string (e.g., "2025-11-20T10:30:00" or "2025-11-20T10:30:00.000Z")
+ * @param fieldName - Field name for error messages (e.g., "Due Date")
+ * @param docsUrl - URL to Zoho Desk API documentation for error messages
+ * @returns ISO 8601 string with milliseconds and timezone (e.g., "2025-11-20T10:30:00.000Z")
+ * @throws Error if dateString is invalid or cannot be parsed
+ */
+function convertDateToTimestamp(dateString, fieldName, docsUrl) {
+    // Validate that date string is not empty or whitespace-only
+    if (!dateString || dateString.trim() === '') {
+        throw new n8n_workflow_1.ApplicationError(`${fieldName} cannot be empty. Expected ISO 8601 format (e.g., "2025-11-20T10:30:00.000Z"). ` +
+            'See: ' +
+            docsUrl);
+    }
+    // Validate date string format
+    const date = new Date(dateString);
+    if (isNaN(date.getTime())) {
+        throw new n8n_workflow_1.ApplicationError(`Invalid ${fieldName} format: "${dateString}". Expected ISO 8601 format (e.g., "2025-11-20T10:30:00.000Z"). ` +
+            'See: ' +
+            docsUrl);
+    }
+    // Return ISO 8601 string format (Zoho Desk API expects ISO 8601 string, not milliseconds timestamp)
+    // If the input doesn't have milliseconds or timezone, add them
+    return date.toISOString();
+}
+/**
+ * Validate email format using RFC 5322 compliant regex (simplified version)
+ * @param email - Email address to validate
+ * @returns True if email format is valid
+ */
+function isValidEmail(email) {
+    // Use pre-compiled RFC 5322 compliant regex for performance
+    // RFC 5321 maximum email length is 254 characters
+    return RFC5322_EMAIL_PATTERN.test(email) && email.length <= FIELD_LENGTH_LIMITS.email;
+}
+/**
+ * Add a contact field with validation and type checking
+ * Reduces code duplication in contact validation
+ * @param contact - Target contact object
+ * @param contactValues - Source contact values
+ * @param fieldName - Name of the field to add
+ * @param fieldLabel - Display label for error messages
+ * @param maxLength - Maximum allowed length for the field (optional)
+ */
+function addContactField(contact, contactValues, fieldName, fieldLabel, maxLength) {
+    // Explicit null/undefined check - don't skip falsy values like 0 or empty string
+    // (empty strings are handled below after trimming)
+    if (contactValues[fieldName] === undefined || contactValues[fieldName] === null)
+        return;
+    const fieldType = typeof contactValues[fieldName];
+    if (fieldType !== 'string' && fieldType !== 'number') {
+        throw new n8n_workflow_1.ApplicationError(`Contact validation failed: ${fieldLabel} must be a string or number, not a complex object. ` +
+            'See: ' +
+            ZOHO_DESK_CREATE_TICKET_DOCS);
+    }
+    // Type check above guarantees only string/number reach this point (no objects/arrays)
+    // Safe to coerce to string since numbers will become their string representation
+    const fieldStr = String(contactValues[fieldName]).trim();
+    if (fieldStr !== '') {
+        // Sanitize CRLF characters (does NOT protect against XSS - handled by Zoho Desk API)
+        const cleaned = validateFieldLength(fieldStr, maxLength, `Contact ${fieldLabel}`);
+        // Additional validation for email field
+        if (fieldName === 'email' && !isValidEmail(cleaned)) {
+            throw new n8n_workflow_1.ApplicationError(`Contact validation failed: Invalid email format "${cleaned}". ` +
+                'See: ' +
+                ZOHO_DESK_CREATE_TICKET_DOCS);
+        }
+        contact[fieldName] = cleaned;
+    }
+}
+/**
+ * Fetch all pages from a paginated Zoho Desk API endpoint
+ * @param context - The IExecuteFunctions context
+ * @param baseUrl - API base URL
+ * @param endpoint - API endpoint (e.g., '/tickets')
+ * @param orgId - Organization ID
+ * @param limit - Items per page (max varies by endpoint, typically 50-200)
+ * @param dataKey - Response key containing data array (default: 'data')
+ * @param queryParams - Additional query parameters to include
+ * @returns Array of all items from all pages
+ */
+async function getAllPaginatedItems(context, baseUrl, endpoint, orgId, limit, dataKey = 'data', queryParams) {
+    const allItems = [];
+    let from = 1;
+    let hasMore = true;
+    while (hasMore) {
+        const options = {
+            method: 'GET',
+            headers: { orgId },
+            uri: `${baseUrl}${endpoint}`,
+            qs: { from, limit, ...queryParams },
+            json: true,
+        };
+        const response = await context.helpers.requestOAuth2.call(context, 'zohoDeskOAuth2Api', options);
+        const items = response[dataKey] || [];
+        allItems.push(...items);
+        if (items.length < limit) {
+            hasMore = false;
+        }
+        else {
+            from += limit;
+        }
+    }
+    return allItems;
+}
+/**
+ * Add common ticket fields (description, secondaryContacts, custom fields)
+ * This eliminates code duplication between create and update operations
+ * @param body - Target object to add fields to
+ * @param fields - Source object containing field values
+ * @param includePriorityAndDueDate - Whether to include priority and dueDate fields (true for update, false for create)
+ *                                     For create operation: priority and dueDate are primary fields, not in additionalFields
+ *                                     For update operation: priority and dueDate are optional fields in updateFields
+ */
+function addCommonTicketFields(body, fields, includePriorityAndDueDate = true) {
+    // Description is now a primary field, so it's not handled here anymore
+    // Only include dueDate and priority for update operation
+    // For create operation, these are primary fields set separately
+    if (includePriorityAndDueDate) {
+        if (fields.dueDate !== undefined) {
+            const dueDateValue = fields.dueDate;
+            if (dueDateValue && dueDateValue.trim() !== '') {
+                // Validate and normalize ISO 8601 string for Zoho Desk API
+                body.dueDate = convertDateToTimestamp(dueDateValue, 'Due Date', ZOHO_DESK_UPDATE_TICKET_DOCS);
+            }
+            else {
+                // Empty string means "no change" for update operation
+                body.dueDate = '';
+            }
+        }
+        if (fields.priority !== undefined) {
+            body.priority = fields.priority;
+        }
+    }
+    if (fields.secondaryContacts !== undefined && typeof fields.secondaryContacts === 'string') {
+        const contacts = parseCommaSeparatedList(fields.secondaryContacts);
+        if (contacts.length > 0) {
+            body.secondaryContacts = contacts;
+        }
+    }
+    if (fields.cf !== undefined) {
+        body.cf = parseCustomFields(fields.cf);
+    }
+}
+class ZohoDesk {
+    constructor() {
+        this.description = {
+            displayName: 'Zoho Desk',
+            name: 'zohoDesk',
+            icon: 'file:zohoDesk.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+            description: 'Manage tickets, contacts, and accounts in Zoho Desk',
+            defaults: {
+                name: 'Zoho Desk',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [
+                {
+                    name: 'zohoDeskOAuth2Api',
+                    required: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Resource',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Account',
+                            value: 'account',
+                        },
+                        {
+                            name: 'Contact',
+                            value: 'contact',
+                        },
+                        {
+                            name: 'Ticket',
+                            value: 'ticket',
+                        },
+                    ],
+                    default: 'ticket',
+                },
+                // ==================== TICKET OPERATIONS ====================
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['ticket'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'Add Comment',
+                            value: 'addComment',
+                            description: 'Add a comment to a ticket',
+                            action: 'Add comment to ticket',
+                        },
+                        {
+                            name: 'Create',
+                            value: 'create',
+                            description: 'Create a new ticket',
+                            action: 'Create a ticket',
+                        },
+                        {
+                            name: 'Delete',
+                            value: 'delete',
+                            description: 'Delete a ticket',
+                            action: 'Delete a ticket',
+                        },
+                        {
+                            name: 'Get',
+                            value: 'get',
+                            description: 'Get a ticket by ID',
+                            action: 'Get a ticket',
+                        },
+                        {
+                            name: 'List',
+                            value: 'list',
+                            description: 'List all tickets',
+                            action: 'List tickets',
+                        },
+                        {
+                            name: 'List Threads',
+                            value: 'listThreads',
+                            description: 'List ticket conversations/threads',
+                            action: 'List ticket threads',
+                        },
+                        {
+                            name: 'Update',
+                            value: 'update',
+                            description: 'Update an existing ticket',
+                            action: 'Update a ticket',
+                        },
+                    ],
+                    default: 'create',
+                },
+                // ==================== CONTACT OPERATIONS ====================
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['contact'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'Create',
+                            value: 'create',
+                            description: 'Create a new contact',
+                            action: 'Create a contact',
+                        },
+                        {
+                            name: 'Delete',
+                            value: 'delete',
+                            description: 'Delete a contact',
+                            action: 'Delete a contact',
+                        },
+                        {
+                            name: 'Get',
+                            value: 'get',
+                            description: 'Get a contact by ID',
+                            action: 'Get a contact',
+                        },
+                        {
+                            name: 'List',
+                            value: 'list',
+                            description: 'List all contacts',
+                            action: 'List contacts',
+                        },
+                        {
+                            name: 'Update',
+                            value: 'update',
+                            description: 'Update a contact',
+                            action: 'Update a contact',
+                        },
+                    ],
+                    default: 'create',
+                },
+                // ==================== ACCOUNT OPERATIONS ====================
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['account'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'Create',
+                            value: 'create',
+                            description: 'Create a new account',
+                            action: 'Create an account',
+                        },
+                        {
+                            name: 'Delete',
+                            value: 'delete',
+                            description: 'Delete an account',
+                            action: 'Delete an account',
+                        },
+                        {
+                            name: 'Get',
+                            value: 'get',
+                            description: 'Get an account by ID',
+                            action: 'Get an account',
+                        },
+                        {
+                            name: 'List',
+                            value: 'list',
+                            description: 'List all accounts',
+                            action: 'List accounts',
+                        },
+                        {
+                            name: 'Update',
+                            value: 'update',
+                            description: 'Update an account',
+                            action: 'Update an account',
+                        },
+                    ],
+                    default: 'create',
+                },
+                // Create Operation Fields
+                {
+                    displayName: 'Department Name or ID',
+                    name: 'departmentId',
+                    type: 'options',
+                    typeOptions: {
+                        loadOptionsMethod: 'getDepartments',
+                    },
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['ticket'],
+                            operation: ['create'],
+                        },
+                    },
+                    default: '',
+                    description: 'The department to which the ticket belongs. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+                },
+                {
+                    displayName: 'Team Name or ID',
+                    name: 'teamId',
+                    type: 'options',
+                    typeOptions: {
+                        loadOptionsMethod: 'getTeams',
+                        loadOptionsDependsOn: ['departmentId'],
+                    },
+                    displayOptions: {
+                        show: {
+                            resource: ['ticket'],
+                            operation: ['create'],
+                        },
+                    },
+                    default: '',
+                    description: 'The team assigned to resolve the ticket. Teams will only load if Department is selected first. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+                },
+                {
+                    displayName: 'Subject',
+                    name: 'subject',
+                    type: 'string',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['ticket'],
+                            operation: ['create'],
+                        },
+                    },
+                    default: '',
+                    description: 'Subject of the ticket',
+                },
+                {
+                    displayName: 'Contact',
+                    name: 'contact',
+                    type: 'fixedCollection',
+                    typeOptions: {
+                        multipleValues: false,
+                    },
+                    displayOptions: {
+                        show: {
+                            resource: ['ticket'],
+                            operation: ['create'],
+                        },
+                    },
+                    default: {},
+                    description: 'Details of the contact who raised the ticket. If email exists, contactId is used; otherwise, a new contact is created. Either lastName or email must be present.',
+                    options: [
+                        {
+                            name: 'contactValues',
+                            displayName: 'Contact Details',
+                            values: [
+                                {
+                                    displayName: 'Email',
+                                    name: 'email',
+                                    type: 'string',
+                                    placeholder: 'name@email.com',
+                                    default: '',
+                                    description: 'Email address of the contact (required if lastName is not provided)',
+                                },
+                                {
+                                    displayName: 'First Name',
+                                    name: 'firstName',
+                                    type: 'string',
+                                    default: '',
+                                    description: 'First name of the contact',
+                                },
+                                {
+                                    displayName: 'Last Name',
+                                    name: 'lastName',
+                                    type: 'string',
+                                    default: '',
+                                    description: 'Last name of the contact (required if email is not provided)',
+                                },
+                                {
+                                    displayName: 'Phone',
+                                    name: 'phone',
+                                    type: 'string',
+                                    default: '',
+                                    description: 'Phone number of the contact',
+                                },
+                            ],
+                        },
+                    ],
+                },
+                {
+                    displayName: 'Priority',
+                    name: 'priority',
+                    type: 'options',
+                    displayOptions: {
+                        show: {
+                            resource: ['ticket'],
+                            operation: ['create'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'Low',
+                            value: 'Low',
+                        },
+                        {
+                            name: 'Medium',
+                            value: 'Medium',
+                        },
+                        {
+                            name: 'High',
+                            value: 'High',
+                        },
+                    ],
+                    default: 'Medium',
+                    description: 'Priority of the ticket',
+                },
+                {
+                    displayName: 'Classification',
+                    name: 'classification',
+                    type: 'options',
+                    displayOptions: {
+                        show: {
+                            resource: ['ticket'],
+                            operation: ['create'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'Question',
+                            value: 'Question',
+                        },
+                        {
+                            name: 'Problem',
+                            value: 'Problem',
+                        },
+                        {
+                            name: 'Request',
+                            value: 'Request',
+                        },
+                        {
+                            name: 'Others',
+                            value: 'Others',
+                        },
+                    ],
+                    default: 'Question',
+                    description: 'Classification of the ticket',
+                },
+                {
+                    displayName: 'Due Date',
+                    name: 'dueDate',
+                    type: 'dateTime',
+                    displayOptions: {
+                        show: {
+                            resource: ['ticket'],
+                            operation: ['create'],
+                        },
+                    },
+                    default: '',
+                    description: 'The due date for resolving the ticket',
+                },
+                {
+                    displayName: 'Description',
+                    name: 'description',
+                    type: 'string',
+                    typeOptions: {
+                        rows: 5,
+                    },
+                    displayOptions: {
+                        show: {
+                            resource: ['ticket'],
+                            operation: ['create'],
+                        },
+                    },
+                    default: '',
+                    description: 'Description of the ticket',
+                },
+                {
+                    displayName: 'Additional Fields',
+                    name: 'additionalFields',
+                    type: 'collection',
+                    placeholder: 'Add Field',
+                    default: {},
+                    displayOptions: {
+                        show: {
+                            resource: ['ticket'],
+                            operation: ['create'],
+                        },
+                    },
+                    options: [
+                        {
+                            displayName: 'Account ID',
+                            name: 'accountId',
+                            type: 'string',
+                            default: '',
+                            description: 'The ID of the account associated with the ticket',
+                        },
+                        {
+                            displayName: 'Assignee ID',
+                            name: 'assigneeId',
+                            type: 'string',
+                            default: '',
+                            description: 'The ID of the agent to whom the ticket is assigned',
+                        },
+                        {
+                            displayName: 'Category',
+                            name: 'category',
+                            type: 'string',
+                            default: '',
+                            description: 'Category to which the ticket belongs',
+                        },
+                        {
+                            displayName: 'Channel',
+                            name: 'channel',
+                            type: 'options',
+                            options: [
+                                {
+                                    name: 'Chat',
+                                    value: 'CHAT',
+                                },
+                                {
+                                    name: 'Email',
+                                    value: 'EMAIL',
+                                },
+                                {
+                                    name: 'Facebook',
+                                    value: 'FACEBOOK',
+                                },
+                                {
+                                    name: 'Feedback Widget',
+                                    value: 'FEEDBACK_WIDGET',
+                                },
+                                {
+                                    name: 'Forums',
+                                    value: 'FORUMS',
+                                },
+                                {
+                                    name: 'Phone',
+                                    value: 'PHONE',
+                                },
+                                {
+                                    name: 'Twitter',
+                                    value: 'TWITTER',
+                                },
+                                {
+                                    name: 'Web',
+                                    value: 'WEB',
+                                },
+                            ],
+                            default: 'EMAIL',
+                            description: 'The channel through which the ticket was created',
+                        },
+                        {
+                            displayName: 'Custom Fields',
+                            name: 'cf',
+                            type: 'json',
+                            default: '',
+                            description: 'Custom fields as JSON object',
+                            placeholder: '{"cf_modelname": "F3 2017", "cf_phone": "123456"}',
+                        },
+                        {
+                            displayName: 'Email',
+                            name: 'email',
+                            type: 'string',
+                            placeholder: 'name@email.com',
+                            default: '',
+                            description: 'Email address of the contact',
+                        },
+                        {
+                            displayName: 'Language',
+                            name: 'language',
+                            type: 'string',
+                            default: '',
+                            description: 'Language in which the ticket was created',
+                        },
+                        {
+                            displayName: 'Phone',
+                            name: 'phone',
+                            type: 'string',
+                            default: '',
+                            description: 'Phone number of the contact',
+                        },
+                        {
+                            displayName: 'Product ID',
+                            name: 'productId',
+                            type: 'string',
+                            default: '',
+                            description: 'The ID of the product associated with the ticket',
+                        },
+                        {
+                            displayName: 'Resolution',
+                            name: 'resolution',
+                            type: 'string',
+                            typeOptions: {
+                                rows: 5,
+                            },
+                            default: '',
+                            description: 'Resolution content of the ticket',
+                        },
+                        {
+                            displayName: 'Secondary Contacts',
+                            name: 'secondaryContacts',
+                            type: 'string',
+                            default: '',
+                            description: 'Comma-separated list of contact IDs for secondary contacts',
+                            placeholder: '1892000000042038, 1892000000042042',
+                        },
+                        {
+                            displayName: 'Status',
+                            name: 'status',
+                            type: 'string',
+                            default: DEFAULT_TICKET_STATUS,
+                            description: `Status of the ticket (default: ${DEFAULT_TICKET_STATUS} for new tickets)`,
+                        },
+                        {
+                            displayName: 'Sub Category',
+                            name: 'subCategory',
+                            type: 'string',
+                            default: '',
+                            description: 'Sub-category to which the ticket belongs',
+                        },
+                    ],
+                },
+                // ==================== TICKET: GET/DELETE/UPDATE/ADDCOMMENT/LISTTHREADS ====================
+                {
+                    displayName: 'Ticket ID',
+                    name: 'ticketId',
+                    type: 'string',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['ticket'],
+                            operation: ['get', 'delete', 'update', 'addComment', 'listThreads'],
+                        },
+                    },
+                    default: '',
+                    description: 'The ID of the ticket',
+                },
+                // ==================== TICKET: LIST ====================
+                {
+                    displayName: 'Return All',
+                    name: 'returnAll',
+                    type: 'boolean',
+                    displayOptions: {
+                        show: {
+                            resource: ['ticket'],
+                            operation: ['list'],
+                        },
+                    },
+                    default: false,
+                    description: 'Whether to return all results or only up to a given limit',
+                },
+                {
+                    displayName: 'Limit',
+                    name: 'limit',
+                    type: 'number',
+                    displayOptions: {
+                        show: {
+                            resource: ['ticket'],
+                            operation: ['list'],
+                            returnAll: [false],
+                        },
+                    },
+                    typeOptions: {
+                        minValue: 1,
+                    },
+                    default: 50,
+                    description: 'Max number of results to return',
+                },
+                {
+                    displayName: 'Filters',
+                    name: 'filters',
+                    type: 'collection',
+                    placeholder: 'Add Filter',
+                    default: {},
+                    displayOptions: {
+                        show: {
+                            resource: ['ticket'],
+                            operation: ['list'],
+                        },
+                    },
+                    options: [
+                        {
+                            displayName: 'Assignee ID',
+                            name: 'assigneeId',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by assignee ID',
+                        },
+                        {
+                            displayName: 'Department ID',
+                            name: 'departmentId',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by department ID',
+                        },
+                        {
+                            displayName: 'Status',
+                            name: 'status',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by status (e.g., Open, On Hold, Closed)',
+                        },
+                    ],
+                },
+                // ==================== TICKET: ADD COMMENT ====================
+                {
+                    displayName: 'Comment Content',
+                    name: 'content',
+                    type: 'string',
+                    typeOptions: {
+                        rows: 4,
+                    },
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['ticket'],
+                            operation: ['addComment'],
+                        },
+                    },
+                    default: '',
+                    description: 'The content of the comment',
+                },
+                {
+                    displayName: 'Is Public',
+                    name: 'isPublic',
+                    type: 'boolean',
+                    displayOptions: {
+                        show: {
+                            resource: ['ticket'],
+                            operation: ['addComment'],
+                        },
+                    },
+                    default: true,
+                    description: 'Whether the comment is visible to customers (public) or internal only (private)',
+                },
+                // ==================== TICKET: LIST THREADS ====================
+                {
+                    displayName: 'Return All',
+                    name: 'returnAll',
+                    type: 'boolean',
+                    displayOptions: {
+                        show: {
+                            resource: ['ticket'],
+                            operation: ['listThreads'],
+                        },
+                    },
+                    default: false,
+                    description: 'Whether to return all threads or only up to a given limit',
+                },
+                {
+                    displayName: 'Limit',
+                    name: 'limit',
+                    type: 'number',
+                    displayOptions: {
+                        show: {
+                            resource: ['ticket'],
+                            operation: ['listThreads'],
+                            returnAll: [false],
+                        },
+                    },
+                    typeOptions: {
+                        minValue: 1,
+                    },
+                    default: 50,
+                    description: 'Max number of results to return',
+                },
+                // ==================== TICKET: UPDATE ====================
+                {
+                    displayName: 'Description',
+                    name: 'description',
+                    type: 'string',
+                    typeOptions: {
+                        rows: 5,
+                    },
+                    displayOptions: {
+                        show: {
+                            resource: ['ticket'],
+                            operation: ['update'],
+                        },
+                    },
+                    default: '',
+                    description: 'Description of the ticket',
+                },
+                {
+                    displayName: 'Update Fields',
+                    name: 'updateFields',
+                    type: 'collection',
+                    placeholder: 'Add Field',
+                    default: {},
+                    displayOptions: {
+                        show: {
+                            resource: ['ticket'],
+                            operation: ['update'],
+                        },
+                    },
+                    options: [
+                        {
+                            displayName: 'Account ID',
+                            name: 'accountId',
+                            type: 'string',
+                            default: '',
+                            description: 'The ID of the account associated with the ticket',
+                        },
+                        {
+                            displayName: 'Assignee ID',
+                            name: 'assigneeId',
+                            type: 'string',
+                            default: '',
+                            description: 'The ID of the agent to whom the ticket is assigned',
+                        },
+                        {
+                            displayName: 'Category',
+                            name: 'category',
+                            type: 'string',
+                            default: '',
+                            description: 'Category to which the ticket belongs',
+                        },
+                        {
+                            displayName: 'Classification',
+                            name: 'classification',
+                            type: 'options',
+                            options: [
+                                {
+                                    name: 'No Change',
+                                    value: '',
+                                },
+                                {
+                                    name: 'Others',
+                                    value: 'Others',
+                                },
+                                {
+                                    name: 'Problem',
+                                    value: 'Problem',
+                                },
+                                {
+                                    name: 'Question',
+                                    value: 'Question',
+                                },
+                                {
+                                    name: 'Request',
+                                    value: 'Request',
+                                },
+                            ],
+                            default: '',
+                            description: 'Classification of the ticket',
+                        },
+                        {
+                            displayName: 'Contact ID',
+                            name: 'contactId',
+                            type: 'string',
+                            default: '',
+                            description: 'The ID of the contact who raised the ticket',
+                        },
+                        {
+                            displayName: 'Custom Fields',
+                            name: 'cf',
+                            type: 'json',
+                            default: '',
+                            description: 'Custom fields as JSON object',
+                            placeholder: '{"cf_modelname": "F3 2017", "cf_phone": "123456"}',
+                        },
+                        {
+                            displayName: 'Department Name or ID',
+                            name: 'departmentId',
+                            type: 'options',
+                            typeOptions: {
+                                loadOptionsMethod: 'getDepartments',
+                            },
+                            default: '',
+                            description: 'The department to which the ticket belongs. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+                        },
+                        {
+                            displayName: 'Due Date',
+                            name: 'dueDate',
+                            type: 'dateTime',
+                            default: '',
+                            description: 'The due date for resolving the ticket (leave empty to keep current due date)',
+                        },
+                        {
+                            displayName: 'Email',
+                            name: 'email',
+                            type: 'string',
+                            placeholder: 'name@email.com',
+                            default: '',
+                            description: 'Email address of the contact',
+                        },
+                        {
+                            displayName: 'Language',
+                            name: 'language',
+                            type: 'string',
+                            default: '',
+                            description: 'Language in which the ticket was created',
+                        },
+                        {
+                            displayName: 'Phone',
+                            name: 'phone',
+                            type: 'string',
+                            default: '',
+                            description: 'Phone number of the contact',
+                        },
+                        {
+                            displayName: 'Priority',
+                            name: 'priority',
+                            type: 'options',
+                            options: [
+                                {
+                                    name: 'No Change',
+                                    value: '',
+                                },
+                                {
+                                    name: 'Low',
+                                    value: 'Low',
+                                },
+                                {
+                                    name: 'Medium',
+                                    value: 'Medium',
+                                },
+                                {
+                                    name: 'High',
+                                    value: 'High',
+                                },
+                            ],
+                            default: '',
+                            description: 'Priority of the ticket',
+                        },
+                        {
+                            displayName: 'Product ID',
+                            name: 'productId',
+                            type: 'string',
+                            default: '',
+                            description: 'The ID of the product associated with the ticket',
+                        },
+                        {
+                            displayName: 'Resolution',
+                            name: 'resolution',
+                            type: 'string',
+                            typeOptions: {
+                                rows: 5,
+                            },
+                            default: '',
+                            description: 'Resolution content of the ticket',
+                        },
+                        {
+                            displayName: 'Secondary Contacts',
+                            name: 'secondaryContacts',
+                            type: 'string',
+                            default: '',
+                            description: 'Comma-separated list of contact IDs for secondary contacts',
+                            placeholder: '1892000000042038, 1892000000042042',
+                        },
+                        {
+                            displayName: 'Status',
+                            name: 'status',
+                            type: 'string',
+                            default: '',
+                            description: 'Status of the ticket (leave empty to keep current status)',
+                        },
+                        {
+                            displayName: 'Sub Category',
+                            name: 'subCategory',
+                            type: 'string',
+                            default: '',
+                            description: 'Sub-category to which the ticket belongs',
+                        },
+                        {
+                            displayName: 'Subject',
+                            name: 'subject',
+                            type: 'string',
+                            default: '',
+                            description: 'Subject of the ticket',
+                        },
+                        {
+                            displayName: 'Team Name or ID',
+                            name: 'teamId',
+                            type: 'options',
+                            typeOptions: {
+                                loadOptionsMethod: 'getTeams',
+                                loadOptionsDependsOn: ['departmentId'],
+                            },
+                            default: '',
+                            description: 'The team assigned to the ticket. Note: Teams will only load if Department is selected first. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+                        },
+                    ],
+                },
+                // ==================== CONTACT PARAMETERS ====================
+                // Contact: Create
+                {
+                    displayName: 'Last Name',
+                    name: 'lastName',
+                    type: 'string',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['contact'],
+                            operation: ['create'],
+                        },
+                    },
+                    default: '',
+                    description: 'Last name of the contact',
+                },
+                {
+                    displayName: 'Email',
+                    name: 'email',
+                    type: 'string',
+                    placeholder: 'name@email.com',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['contact'],
+                            operation: ['create'],
+                        },
+                    },
+                    default: '',
+                    description: 'Email address of the contact',
+                },
+                {
+                    displayName: 'Additional Fields',
+                    name: 'additionalFields',
+                    type: 'collection',
+                    placeholder: 'Add Field',
+                    default: {},
+                    displayOptions: {
+                        show: {
+                            resource: ['contact'],
+                            operation: ['create'],
+                        },
+                    },
+                    options: [
+                        {
+                            displayName: 'Account ID',
+                            name: 'accountId',
+                            type: 'string',
+                            default: '',
+                            description: 'The ID of the account associated with this contact',
+                        },
+                        {
+                            displayName: 'Custom Fields',
+                            name: 'cf',
+                            type: 'json',
+                            default: '',
+                            description: 'Custom fields as JSON object',
+                            placeholder: '{"cf_field": "value"}',
+                        },
+                        {
+                            displayName: 'Description',
+                            name: 'description',
+                            type: 'string',
+                            typeOptions: {
+                                rows: 4,
+                            },
+                            default: '',
+                            description: 'Description of the contact',
+                        },
+                        {
+                            displayName: 'Facebook',
+                            name: 'facebook',
+                            type: 'string',
+                            default: '',
+                            description: 'Facebook handle of the contact',
+                        },
+                        {
+                            displayName: 'First Name',
+                            name: 'firstName',
+                            type: 'string',
+                            default: '',
+                            description: 'First name of the contact',
+                        },
+                        {
+                            displayName: 'Mobile',
+                            name: 'mobile',
+                            type: 'string',
+                            default: '',
+                            description: 'Mobile number of the contact',
+                        },
+                        {
+                            displayName: 'Phone',
+                            name: 'phone',
+                            type: 'string',
+                            default: '',
+                            description: 'Phone number of the contact',
+                        },
+                        {
+                            displayName: 'Twitter',
+                            name: 'twitter',
+                            type: 'string',
+                            default: '',
+                            description: 'Twitter handle of the contact',
+                        },
+                        {
+                            displayName: 'Type',
+                            name: 'type',
+                            type: 'string',
+                            default: '',
+                            description: 'Type of the contact',
+                        },
+                    ],
+                },
+                // Contact: Get/Delete/Update
+                {
+                    displayName: 'Contact ID',
+                    name: 'contactId',
+                    type: 'string',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['contact'],
+                            operation: ['get', 'delete', 'update'],
+                        },
+                    },
+                    default: '',
+                    description: 'The ID of the contact',
+                },
+                // Contact: List
+                {
+                    displayName: 'Return All',
+                    name: 'returnAll',
+                    type: 'boolean',
+                    displayOptions: {
+                        show: {
+                            resource: ['contact'],
+                            operation: ['list'],
+                        },
+                    },
+                    default: false,
+                    description: 'Whether to return all results or only up to a given limit',
+                },
+                {
+                    displayName: 'Limit',
+                    name: 'limit',
+                    type: 'number',
+                    displayOptions: {
+                        show: {
+                            resource: ['contact'],
+                            operation: ['list'],
+                            returnAll: [false],
+                        },
+                    },
+                    typeOptions: {
+                        minValue: 1,
+                    },
+                    default: 50,
+                    description: 'Max number of results to return',
+                },
+                // Contact: Update
+                {
+                    displayName: 'Update Fields',
+                    name: 'updateFields',
+                    type: 'collection',
+                    placeholder: 'Add Field',
+                    default: {},
+                    displayOptions: {
+                        show: {
+                            resource: ['contact'],
+                            operation: ['update'],
+                        },
+                    },
+                    options: [
+                        {
+                            displayName: 'Account ID',
+                            name: 'accountId',
+                            type: 'string',
+                            default: '',
+                            description: 'The ID of the account associated with this contact',
+                        },
+                        {
+                            displayName: 'Custom Fields',
+                            name: 'cf',
+                            type: 'json',
+                            default: '',
+                            description: 'Custom fields as JSON object',
+                            placeholder: '{"cf_field": "value"}',
+                        },
+                        {
+                            displayName: 'Description',
+                            name: 'description',
+                            type: 'string',
+                            typeOptions: {
+                                rows: 4,
+                            },
+                            default: '',
+                            description: 'Description of the contact',
+                        },
+                        {
+                            displayName: 'Email',
+                            name: 'email',
+                            type: 'string',
+                            placeholder: 'name@email.com',
+                            default: '',
+                            description: 'Email address of the contact',
+                        },
+                        {
+                            displayName: 'Facebook',
+                            name: 'facebook',
+                            type: 'string',
+                            default: '',
+                            description: 'Facebook handle of the contact',
+                        },
+                        {
+                            displayName: 'First Name',
+                            name: 'firstName',
+                            type: 'string',
+                            default: '',
+                            description: 'First name of the contact',
+                        },
+                        {
+                            displayName: 'Last Name',
+                            name: 'lastName',
+                            type: 'string',
+                            default: '',
+                            description: 'Last name of the contact',
+                        },
+                        {
+                            displayName: 'Mobile',
+                            name: 'mobile',
+                            type: 'string',
+                            default: '',
+                            description: 'Mobile number of the contact',
+                        },
+                        {
+                            displayName: 'Phone',
+                            name: 'phone',
+                            type: 'string',
+                            default: '',
+                            description: 'Phone number of the contact',
+                        },
+                        {
+                            displayName: 'Twitter',
+                            name: 'twitter',
+                            type: 'string',
+                            default: '',
+                            description: 'Twitter handle of the contact',
+                        },
+                        {
+                            displayName: 'Type',
+                            name: 'type',
+                            type: 'string',
+                            default: '',
+                            description: 'Type of the contact',
+                        },
+                    ],
+                },
+                // ==================== ACCOUNT PARAMETERS ====================
+                // Account: Create
+                {
+                    displayName: 'Account Name',
+                    name: 'accountName',
+                    type: 'string',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['account'],
+                            operation: ['create'],
+                        },
+                    },
+                    default: '',
+                    description: 'Name of the account',
+                },
+                {
+                    displayName: 'Additional Fields',
+                    name: 'additionalFields',
+                    type: 'collection',
+                    placeholder: 'Add Field',
+                    default: {},
+                    displayOptions: {
+                        show: {
+                            resource: ['account'],
+                            operation: ['create'],
+                        },
+                    },
+                    options: [
+                        {
+                            displayName: 'City',
+                            name: 'city',
+                            type: 'string',
+                            default: '',
+                            description: 'City of the account',
+                        },
+                        {
+                            displayName: 'Code',
+                            name: 'code',
+                            type: 'string',
+                            default: '',
+                            description: 'Account code',
+                        },
+                        {
+                            displayName: 'Country',
+                            name: 'country',
+                            type: 'string',
+                            default: '',
+                            description: 'Country of the account',
+                        },
+                        {
+                            displayName: 'Custom Fields',
+                            name: 'cf',
+                            type: 'json',
+                            default: '',
+                            description: 'Custom fields as JSON object',
+                            placeholder: '{"cf_field": "value"}',
+                        },
+                        {
+                            displayName: 'Description',
+                            name: 'description',
+                            type: 'string',
+                            typeOptions: {
+                                rows: 4,
+                            },
+                            default: '',
+                            description: 'Description of the account',
+                        },
+                        {
+                            displayName: 'Fax',
+                            name: 'fax',
+                            type: 'string',
+                            default: '',
+                            description: 'Fax number of the account',
+                        },
+                        {
+                            displayName: 'Industry',
+                            name: 'industry',
+                            type: 'string',
+                            default: '',
+                            description: 'Industry of the account',
+                        },
+                        {
+                            displayName: 'Phone',
+                            name: 'phone',
+                            type: 'string',
+                            default: '',
+                            description: 'Phone number of the account',
+                        },
+                        {
+                            displayName: 'State',
+                            name: 'state',
+                            type: 'string',
+                            default: '',
+                            description: 'State of the account',
+                        },
+                        {
+                            displayName: 'Street',
+                            name: 'street',
+                            type: 'string',
+                            default: '',
+                            description: 'Street address of the account',
+                        },
+                        {
+                            displayName: 'Website',
+                            name: 'website',
+                            type: 'string',
+                            default: '',
+                            description: 'Website URL of the account',
+                        },
+                        {
+                            displayName: 'Zip',
+                            name: 'zip',
+                            type: 'string',
+                            default: '',
+                            description: 'ZIP/Postal code of the account',
+                        },
+                    ],
+                },
+                // Account: Get/Delete/Update
+                {
+                    displayName: 'Account ID',
+                    name: 'accountId',
+                    type: 'string',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['account'],
+                            operation: ['get', 'delete', 'update'],
+                        },
+                    },
+                    default: '',
+                    description: 'The ID of the account',
+                },
+                // Account: List
+                {
+                    displayName: 'Return All',
+                    name: 'returnAll',
+                    type: 'boolean',
+                    displayOptions: {
+                        show: {
+                            resource: ['account'],
+                            operation: ['list'],
+                        },
+                    },
+                    default: false,
+                    description: 'Whether to return all results or only up to a given limit',
+                },
+                {
+                    displayName: 'Limit',
+                    name: 'limit',
+                    type: 'number',
+                    displayOptions: {
+                        show: {
+                            resource: ['account'],
+                            operation: ['list'],
+                            returnAll: [false],
+                        },
+                    },
+                    typeOptions: {
+                        minValue: 1,
+                    },
+                    default: 50,
+                    description: 'Max number of results to return',
+                },
+                // Account: Update
+                {
+                    displayName: 'Update Fields',
+                    name: 'updateFields',
+                    type: 'collection',
+                    placeholder: 'Add Field',
+                    default: {},
+                    displayOptions: {
+                        show: {
+                            resource: ['account'],
+                            operation: ['update'],
+                        },
+                    },
+                    options: [
+                        {
+                            displayName: 'Account Name',
+                            name: 'accountName',
+                            type: 'string',
+                            default: '',
+                            description: 'Name of the account',
+                        },
+                        {
+                            displayName: 'City',
+                            name: 'city',
+                            type: 'string',
+                            default: '',
+                            description: 'City of the account',
+                        },
+                        {
+                            displayName: 'Code',
+                            name: 'code',
+                            type: 'string',
+                            default: '',
+                            description: 'Account code',
+                        },
+                        {
+                            displayName: 'Country',
+                            name: 'country',
+                            type: 'string',
+                            default: '',
+                            description: 'Country of the account',
+                        },
+                        {
+                            displayName: 'Custom Fields',
+                            name: 'cf',
+                            type: 'json',
+                            default: '',
+                            description: 'Custom fields as JSON object',
+                            placeholder: '{"cf_field": "value"}',
+                        },
+                        {
+                            displayName: 'Description',
+                            name: 'description',
+                            type: 'string',
+                            typeOptions: {
+                                rows: 4,
+                            },
+                            default: '',
+                            description: 'Description of the account',
+                        },
+                        {
+                            displayName: 'Fax',
+                            name: 'fax',
+                            type: 'string',
+                            default: '',
+                            description: 'Fax number of the account',
+                        },
+                        {
+                            displayName: 'Industry',
+                            name: 'industry',
+                            type: 'string',
+                            default: '',
+                            description: 'Industry of the account',
+                        },
+                        {
+                            displayName: 'Phone',
+                            name: 'phone',
+                            type: 'string',
+                            default: '',
+                            description: 'Phone number of the account',
+                        },
+                        {
+                            displayName: 'State',
+                            name: 'state',
+                            type: 'string',
+                            default: '',
+                            description: 'State of the account',
+                        },
+                        {
+                            displayName: 'Street',
+                            name: 'street',
+                            type: 'string',
+                            default: '',
+                            description: 'Street address of the account',
+                        },
+                        {
+                            displayName: 'Website',
+                            name: 'website',
+                            type: 'string',
+                            default: '',
+                            description: 'Website URL of the account',
+                        },
+                        {
+                            displayName: 'Zip',
+                            name: 'zip',
+                            type: 'string',
+                            default: '',
+                            description: 'ZIP/Postal code of the account',
+                        },
+                    ],
+                },
+            ],
+        };
+        this.methods = {
+            loadOptions: {
+                /**
+                 * Load all departments from Zoho Desk
+                 * @returns Array of department options for dropdown
+                 */
+                async getDepartments() {
+                    try {
+                        const credentials = await this.getCredentials('zohoDeskOAuth2Api');
+                        const orgId = credentials.orgId;
+                        const baseUrl = credentials.baseUrl || DEFAULT_BASE_URL;
+                        const options = {
+                            method: 'GET',
+                            headers: {
+                                orgId: orgId,
+                            },
+                            uri: `${baseUrl}/departments`,
+                            json: true,
+                        };
+                        const response = await this.helpers.requestOAuth2.call(this, 'zohoDeskOAuth2Api', options);
+                        // Runtime validation of API response structure
+                        if (!response ||
+                            typeof response !== 'object' ||
+                            !('data' in response) ||
+                            !Array.isArray(response.data)) {
+                            throw new n8n_workflow_1.ApplicationError('Invalid API response structure from Zoho Desk');
+                        }
+                        const typedResponse = response;
+                        return typedResponse.data.map((department) => ({
+                            name: department.name,
+                            value: department.id,
+                        }));
+                    }
+                    catch (error) {
+                        // Return error option in dropdown so users can see what went wrong
+                        const errorMessage = error instanceof Error ? error.message : String(error);
+                        return [
+                            {
+                                name: `⚠️ Error loading departments: ${errorMessage}`,
+                                value: '',
+                            },
+                        ];
+                    }
+                },
+                /**
+                 * Load teams for a specific department from Zoho Desk
+                 * @returns Array of team options for dropdown, or empty array if department not selected
+                 */
+                async getTeams() {
+                    try {
+                        const credentials = await this.getCredentials('zohoDeskOAuth2Api');
+                        const orgId = credentials.orgId;
+                        const baseUrl = credentials.baseUrl || DEFAULT_BASE_URL;
+                        const departmentId = this.getCurrentNodeParameter('departmentId');
+                        // Type guard: departmentId is optional in update operation
+                        if (!departmentId || typeof departmentId !== 'string') {
+                            return [];
+                        }
+                        const options = {
+                            method: 'GET',
+                            headers: {
+                                orgId: orgId,
+                            },
+                            uri: `${baseUrl}/departments/${encodeURIComponent(departmentId)}/teams`,
+                            json: true,
+                        };
+                        const response = await this.helpers.requestOAuth2.call(this, 'zohoDeskOAuth2Api', options);
+                        // Runtime validation of API response structure with detailed error reporting
+                        // Note: Teams endpoint uses 'teams' property instead of 'data'
+                        if (!response || typeof response !== 'object') {
+                            throw new n8n_workflow_1.ApplicationError(`Invalid API response structure from Zoho Desk. Expected an object, received: ${typeof response}. ` +
+                                `Response: ${JSON.stringify(response)}`);
+                        }
+                        if (!('teams' in response)) {
+                            throw new n8n_workflow_1.ApplicationError(`Invalid API response structure from Zoho Desk. Missing 'teams' property. ` +
+                                `Response keys: ${Object.keys(response).join(', ')}. ` +
+                                `Response: ${JSON.stringify(response)}`);
+                        }
+                        if (!Array.isArray(response.teams)) {
+                            throw new n8n_workflow_1.ApplicationError(`Invalid API response structure from Zoho Desk. Expected 'teams' to be an array, received: ${typeof response.teams}. ` +
+                                `Response: ${JSON.stringify(response)}`);
+                        }
+                        const typedResponse = response;
+                        return typedResponse.teams.map((team) => ({
+                            name: team.name,
+                            value: team.id,
+                        }));
+                    }
+                    catch (error) {
+                        // Return error option in dropdown so users can see what went wrong
+                        const errorMessage = error instanceof Error ? error.message : String(error);
+                        return [
+                            {
+                                name: `⚠️ Error loading teams: ${errorMessage}`,
+                                value: '',
+                            },
+                        ];
+                    }
+                },
+            },
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const resource = this.getNodeParameter('resource', 0);
+        const operation = this.getNodeParameter('operation', 0);
+        // Fetch credentials once for all items (optimization)
+        const credentials = await this.getCredentials('zohoDeskOAuth2Api');
+        const orgId = credentials.orgId;
+        const baseUrl = credentials.baseUrl || DEFAULT_BASE_URL;
+        for (let i = 0; i < items.length; i++) {
+            try {
+                if (resource === 'ticket') {
+                    if (operation === 'create') {
+                        // Create ticket
+                        const departmentId = this.getNodeParameter('departmentId', i);
+                        const teamId = this.getNodeParameter('teamId', i);
+                        const rawSubject = this.getNodeParameter('subject', i);
+                        const contactData = this.getNodeParameter('contact', i);
+                        const priority = this.getNodeParameter('priority', i);
+                        const classification = this.getNodeParameter('classification', i);
+                        const dueDate = this.getNodeParameter('dueDate', i);
+                        const description = this.getNodeParameter('description', i);
+                        const additionalFields = this.getNodeParameter('additionalFields', i);
+                        // Validate length for subject (XSS protection handled by Zoho Desk API)
+                        // No length limit - let Zoho Desk API validate
+                        const subject = validateFieldLength(rawSubject, undefined, 'Subject');
+                        const body = {
+                            departmentId,
+                            subject,
+                            priority,
+                            classification,
+                        };
+                        // Add teamId if provided (optional field, same level as departmentId)
+                        if (teamId && teamId.trim() !== '') {
+                            body.teamId = teamId;
+                        }
+                        // Add dueDate if provided - validate and normalize ISO 8601 string
+                        if (dueDate && dueDate.trim() !== '') {
+                            // n8n dateTime field returns ISO 8601 string, Zoho Desk API expects ISO 8601 with milliseconds and timezone
+                            body.dueDate = convertDateToTimestamp(dueDate, 'Due Date', ZOHO_DESK_CREATE_TICKET_DOCS);
+                        }
+                        // Add description if provided
+                        if (description) {
+                            body.description = validateFieldLength(description, undefined, 'Description');
+                        }
+                        // Handle and validate contact object (OPTIONAL)
+                        // Contact field is optional in UI (required: false) but if provided, must be valid
+                        // Contact auto-creation flow (when provided):
+                        // 1. If email exists in Zoho Desk → Existing contact is used
+                        // 2. If email doesn't exist → New contact is created with provided details
+                        // 3. Either email OR lastName must be provided (Zoho Desk requirement)
+                        if (contactData && contactData.contactValues) {
+                            const contactValues = contactData.contactValues;
+                            // Type guard for contactValues using isPlainObject helper
+                            if (!isPlainObject(contactValues)) {
+                                throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Contact validation failed: Invalid contact data format. ' +
+                                    'See: ' +
+                                    ZOHO_DESK_CREATE_TICKET_DOCS);
+                            }
+                            // Check if any non-empty values exist before processing
+                            // This prevents unnecessary validation errors when user provides empty contact fields
+                            const hasNonEmptyValue = Object.values(contactValues).some((value) => value && String(value).trim() !== '');
+                            if (hasNonEmptyValue) {
+                                // Build contact object with available non-empty fields
+                                // Zoho Desk will automatically match by email or create new contact
+                                // Type validation ensures we only coerce strings/numbers, not complex objects
+                                const contact = {};
+                                // Use helper function to add contact fields with validation and CRLF sanitization
+                                // Only email has a documented length limit (RFC 5321), others validated by API
+                                addContactField(contact, contactValues, 'email', 'email', FIELD_LENGTH_LIMITS.email);
+                                addContactField(contact, contactValues, 'lastName', 'lastName', undefined);
+                                addContactField(contact, contactValues, 'firstName', 'firstName', undefined);
+                                addContactField(contact, contactValues, 'phone', 'phone', undefined);
+                                // Validation: if contact has values, ensure at least email or lastName is present
+                                // This catches edge cases where only firstName/phone are provided
+                                if (!contact.email && !contact.lastName) {
+                                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Contact validation failed: Either email or lastName must be provided. ' +
+                                        'See: ' +
+                                        ZOHO_DESK_CREATE_TICKET_DOCS);
+                                }
+                                body.contact = contact;
+                            }
+                            // If all values are empty, skip contact entirely (no error thrown)
+                        }
+                        // Add common fields (description, secondaryContacts, custom fields)
+                        // Note: priority and dueDate are already set as primary fields above
+                        addCommonTicketFields(body, additionalFields, false);
+                        // Add other additional fields
+                        addOptionalFields(body, additionalFields, TICKET_CREATE_OPTIONAL_FIELDS);
+                        const options = {
+                            method: 'POST',
+                            headers: {
+                                orgId: orgId,
+                            },
+                            body,
+                            uri: `${baseUrl}/tickets`,
+                            json: true,
+                        };
+                        const response = await this.helpers.requestOAuth2.call(this, 'zohoDeskOAuth2Api', options);
+                        returnData.push({
+                            json: response,
+                            pairedItem: { item: i },
+                        });
+                    }
+                    if (operation === 'update') {
+                        // Update ticket
+                        const ticketId = this.getNodeParameter('ticketId', i);
+                        const description = this.getNodeParameter('description', i);
+                        const updateFields = this.getNodeParameter('updateFields', i);
+                        // Validate ticket ID format (should be numeric)
+                        if (!isValidTicketId(ticketId)) {
+                            throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Invalid ticket ID format: "${ticketId}". Ticket ID must be a numeric value. ` +
+                                'See: ' +
+                                ZOHO_DESK_UPDATE_TICKET_DOCS);
+                        }
+                        const body = {};
+                        // Add common fields (description, dueDate, priority, secondaryContacts, custom fields)
+                        addCommonTicketFields(body, updateFields);
+                        // Add other update fields
+                        // Add description if provided
+                        if (description) {
+                            body.description = validateFieldLength(description, undefined, 'Description');
+                        }
+                        addOptionalFields(body, updateFields, TICKET_UPDATE_OPTIONAL_FIELDS);
+                        const options = {
+                            method: 'PATCH',
+                            headers: {
+                                orgId: orgId,
+                            },
+                            body,
+                            uri: `${baseUrl}/tickets/${encodeURIComponent(ticketId)}`,
+                            json: true,
+                        };
+                        const response = await this.helpers.requestOAuth2.call(this, 'zohoDeskOAuth2Api', options);
+                        returnData.push({
+                            json: response,
+                            pairedItem: { item: i },
+                        });
+                    }
+                    if (operation === 'get') {
+                        const ticketId = this.getNodeParameter('ticketId', i);
+                        if (!isValidTicketId(ticketId)) {
+                            throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Invalid ticket ID format: "${ticketId}". Ticket ID must be a numeric value. ` +
+                                'See: ' +
+                                ZOHO_DESK_GET_TICKET_DOCS);
+                        }
+                        const options = {
+                            method: 'GET',
+                            headers: { orgId },
+                            uri: `${baseUrl}/tickets/${encodeURIComponent(ticketId)}`,
+                            json: true,
+                        };
+                        const response = await this.helpers.requestOAuth2.call(this, 'zohoDeskOAuth2Api', options);
+                        returnData.push({
+                            json: response,
+                            pairedItem: { item: i },
+                        });
+                    }
+                    if (operation === 'list') {
+                        const returnAll = this.getNodeParameter('returnAll', i);
+                        const filters = this.getNodeParameter('filters', i);
+                        // Build query params from filters
+                        const queryParams = {};
+                        if (filters.departmentId)
+                            queryParams.departmentId = filters.departmentId;
+                        if (filters.assigneeId)
+                            queryParams.assigneeId = filters.assigneeId;
+                        if (filters.status)
+                            queryParams.status = filters.status;
+                        if (returnAll) {
+                            const items = await getAllPaginatedItems(this, baseUrl, '/tickets', orgId, 100, 'data', queryParams);
+                            for (const item of items) {
+                                returnData.push({
+                                    json: item,
+                                    pairedItem: { item: i },
+                                });
+                            }
+                        }
+                        else {
+                            const limit = this.getNodeParameter('limit', i);
+                            const options = {
+                                method: 'GET',
+                                headers: { orgId },
+                                uri: `${baseUrl}/tickets`,
+                                qs: { from: 1, limit, ...queryParams },
+                                json: true,
+                            };
+                            const response = await this.helpers.requestOAuth2.call(this, 'zohoDeskOAuth2Api', options);
+                            for (const ticket of response.data || []) {
+                                returnData.push({
+                                    json: ticket,
+                                    pairedItem: { item: i },
+                                });
+                            }
+                        }
+                    }
+                    if (operation === 'delete') {
+                        const ticketId = this.getNodeParameter('ticketId', i);
+                        if (!isValidTicketId(ticketId)) {
+                            throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Invalid ticket ID format: "${ticketId}". Ticket ID must be a numeric value. ` +
+                                'See: ' +
+                                ZOHO_DESK_UPDATE_TICKET_DOCS);
+                        }
+                        const options = {
+                            method: 'POST',
+                            headers: { orgId },
+                            uri: `${baseUrl}/tickets/moveToTrash`,
+                            body: { ticketIds: [ticketId] },
+                            json: true,
+                        };
+                        await this.helpers.requestOAuth2.call(this, 'zohoDeskOAuth2Api', options);
+                        returnData.push({
+                            json: { success: true, ticketId },
+                            pairedItem: { item: i },
+                        });
+                    }
+                    if (operation === 'addComment') {
+                        const ticketId = this.getNodeParameter('ticketId', i);
+                        const content = this.getNodeParameter('content', i);
+                        const isPublic = this.getNodeParameter('isPublic', i);
+                        if (!isValidTicketId(ticketId)) {
+                            throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Invalid ticket ID format: "${ticketId}". Ticket ID must be a numeric value. ` +
+                                'See: ' +
+                                ZOHO_DESK_COMMENTS_DOCS);
+                        }
+                        const body = {
+                            content: validateFieldLength(content, undefined, 'Comment Content'),
+                            isPublic,
+                        };
+                        const options = {
+                            method: 'POST',
+                            headers: { orgId },
+                            uri: `${baseUrl}/tickets/${encodeURIComponent(ticketId)}/comments`,
+                            body,
+                            json: true,
+                        };
+                        const response = await this.helpers.requestOAuth2.call(this, 'zohoDeskOAuth2Api', options);
+                        returnData.push({
+                            json: response,
+                            pairedItem: { item: i },
+                        });
+                    }
+                    if (operation === 'listThreads') {
+                        const ticketId = this.getNodeParameter('ticketId', i);
+                        const returnAll = this.getNodeParameter('returnAll', i);
+                        if (!isValidTicketId(ticketId)) {
+                            throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Invalid ticket ID format: "${ticketId}". Ticket ID must be a numeric value. ` +
+                                'See: ' +
+                                ZOHO_DESK_THREADS_DOCS);
+                        }
+                        if (returnAll) {
+                            const items = await getAllPaginatedItems(this, baseUrl, `/tickets/${encodeURIComponent(ticketId)}/conversations`, orgId, 100, 'data');
+                            for (const item of items) {
+                                returnData.push({
+                                    json: item,
+                                    pairedItem: { item: i },
+                                });
+                            }
+                        }
+                        else {
+                            const limit = this.getNodeParameter('limit', i);
+                            const options = {
+                                method: 'GET',
+                                headers: { orgId },
+                                uri: `${baseUrl}/tickets/${encodeURIComponent(ticketId)}/conversations`,
+                                qs: { from: 1, limit },
+                                json: true,
+                            };
+                            const response = await this.helpers.requestOAuth2.call(this, 'zohoDeskOAuth2Api', options);
+                            for (const thread of response.data || []) {
+                                returnData.push({
+                                    json: thread,
+                                    pairedItem: { item: i },
+                                });
+                            }
+                        }
+                    }
+                }
+                // ==================== CONTACT RESOURCE ====================
+                if (resource === 'contact') {
+                    if (operation === 'create') {
+                        const lastName = this.getNodeParameter('lastName', i);
+                        const email = this.getNodeParameter('email', i);
+                        const additionalFields = this.getNodeParameter('additionalFields', i);
+                        if (!isValidEmail(email)) {
+                            throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Invalid email format: "${email}". See: ${ZOHO_DESK_CONTACTS_DOCS}`);
+                        }
+                        const body = {
+                            lastName: validateFieldLength(lastName, undefined, 'Last Name'),
+                            email: validateFieldLength(email, FIELD_LENGTH_LIMITS.email, 'Email'),
+                        };
+                        addOptionalFields(body, additionalFields, CONTACT_CREATE_OPTIONAL_FIELDS);
+                        if (additionalFields.cf !== undefined) {
+                            body.cf = parseCustomFields(additionalFields.cf);
+                        }
+                        const options = {
+                            method: 'POST',
+                            headers: { orgId },
+                            uri: `${baseUrl}/contacts`,
+                            body,
+                            json: true,
+                        };
+                        const response = await this.helpers.requestOAuth2.call(this, 'zohoDeskOAuth2Api', options);
+                        returnData.push({
+                            json: response,
+                            pairedItem: { item: i },
+                        });
+                    }
+                    if (operation === 'get') {
+                        const contactId = this.getNodeParameter('contactId', i);
+                        isValidZohoDeskId(contactId, 'Contact ID');
+                        const options = {
+                            method: 'GET',
+                            headers: { orgId },
+                            uri: `${baseUrl}/contacts/${encodeURIComponent(contactId)}`,
+                            json: true,
+                        };
+                        const response = await this.helpers.requestOAuth2.call(this, 'zohoDeskOAuth2Api', options);
+                        returnData.push({
+                            json: response,
+                            pairedItem: { item: i },
+                        });
+                    }
+                    if (operation === 'list') {
+                        const returnAll = this.getNodeParameter('returnAll', i);
+                        if (returnAll) {
+                            const items = await getAllPaginatedItems(this, baseUrl, '/contacts', orgId, 100, 'data');
+                            for (const item of items) {
+                                returnData.push({
+                                    json: item,
+                                    pairedItem: { item: i },
+                                });
+                            }
+                        }
+                        else {
+                            const limit = this.getNodeParameter('limit', i);
+                            const options = {
+                                method: 'GET',
+                                headers: { orgId },
+                                uri: `${baseUrl}/contacts`,
+                                qs: { from: 1, limit },
+                                json: true,
+                            };
+                            const response = await this.helpers.requestOAuth2.call(this, 'zohoDeskOAuth2Api', options);
+                            for (const contact of response.data || []) {
+                                returnData.push({
+                                    json: contact,
+                                    pairedItem: { item: i },
+                                });
+                            }
+                        }
+                    }
+                    if (operation === 'update') {
+                        const contactId = this.getNodeParameter('contactId', i);
+                        const updateFields = this.getNodeParameter('updateFields', i);
+                        isValidZohoDeskId(contactId, 'Contact ID');
+                        const body = {};
+                        addOptionalFields(body, updateFields, CONTACT_UPDATE_OPTIONAL_FIELDS);
+                        if (updateFields.cf !== undefined) {
+                            body.cf = parseCustomFields(updateFields.cf);
+                        }
+                        const options = {
+                            method: 'PATCH',
+                            headers: { orgId },
+                            uri: `${baseUrl}/contacts/${encodeURIComponent(contactId)}`,
+                            body,
+                            json: true,
+                        };
+                        const response = await this.helpers.requestOAuth2.call(this, 'zohoDeskOAuth2Api', options);
+                        returnData.push({
+                            json: response,
+                            pairedItem: { item: i },
+                        });
+                    }
+                    if (operation === 'delete') {
+                        const contactId = this.getNodeParameter('contactId', i);
+                        isValidZohoDeskId(contactId, 'Contact ID');
+                        const options = {
+                            method: 'POST',
+                            headers: { orgId },
+                            uri: `${baseUrl}/contacts/moveToTrash`,
+                            body: { contactIds: [contactId] },
+                            json: true,
+                        };
+                        await this.helpers.requestOAuth2.call(this, 'zohoDeskOAuth2Api', options);
+                        returnData.push({
+                            json: { success: true, contactId },
+                            pairedItem: { item: i },
+                        });
+                    }
+                }
+                // ==================== ACCOUNT RESOURCE ====================
+                if (resource === 'account') {
+                    if (operation === 'create') {
+                        const accountName = this.getNodeParameter('accountName', i);
+                        const additionalFields = this.getNodeParameter('additionalFields', i);
+                        const body = {
+                            accountName: validateFieldLength(accountName, undefined, 'Account Name'),
+                        };
+                        addOptionalFields(body, additionalFields, ACCOUNT_CREATE_OPTIONAL_FIELDS);
+                        if (additionalFields.cf !== undefined) {
+                            body.cf = parseCustomFields(additionalFields.cf);
+                        }
+                        const options = {
+                            method: 'POST',
+                            headers: { orgId },
+                            uri: `${baseUrl}/accounts`,
+                            body,
+                            json: true,
+                        };
+                        const response = await this.helpers.requestOAuth2.call(this, 'zohoDeskOAuth2Api', options);
+                        returnData.push({
+                            json: response,
+                            pairedItem: { item: i },
+                        });
+                    }
+                    if (operation === 'get') {
+                        const accountId = this.getNodeParameter('accountId', i);
+                        isValidZohoDeskId(accountId, 'Account ID');
+                        const options = {
+                            method: 'GET',
+                            headers: { orgId },
+                            uri: `${baseUrl}/accounts/${encodeURIComponent(accountId)}`,
+                            json: true,
+                        };
+                        const response = await this.helpers.requestOAuth2.call(this, 'zohoDeskOAuth2Api', options);
+                        returnData.push({
+                            json: response,
+                            pairedItem: { item: i },
+                        });
+                    }
+                    if (operation === 'list') {
+                        const returnAll = this.getNodeParameter('returnAll', i);
+                        if (returnAll) {
+                            const items = await getAllPaginatedItems(this, baseUrl, '/accounts', orgId, 100, 'data');
+                            for (const item of items) {
+                                returnData.push({
+                                    json: item,
+                                    pairedItem: { item: i },
+                                });
+                            }
+                        }
+                        else {
+                            const limit = this.getNodeParameter('limit', i);
+                            const options = {
+                                method: 'GET',
+                                headers: { orgId },
+                                uri: `${baseUrl}/accounts`,
+                                qs: { from: 1, limit },
+                                json: true,
+                            };
+                            const response = await this.helpers.requestOAuth2.call(this, 'zohoDeskOAuth2Api', options);
+                            for (const account of response.data || []) {
+                                returnData.push({
+                                    json: account,
+                                    pairedItem: { item: i },
+                                });
+                            }
+                        }
+                    }
+                    if (operation === 'update') {
+                        const accountId = this.getNodeParameter('accountId', i);
+                        const updateFields = this.getNodeParameter('updateFields', i);
+                        isValidZohoDeskId(accountId, 'Account ID');
+                        const body = {};
+                        addOptionalFields(body, updateFields, ACCOUNT_UPDATE_OPTIONAL_FIELDS);
+                        if (updateFields.cf !== undefined) {
+                            body.cf = parseCustomFields(updateFields.cf);
+                        }
+                        const options = {
+                            method: 'PATCH',
+                            headers: { orgId },
+                            uri: `${baseUrl}/accounts/${encodeURIComponent(accountId)}`,
+                            body,
+                            json: true,
+                        };
+                        const response = await this.helpers.requestOAuth2.call(this, 'zohoDeskOAuth2Api', options);
+                        returnData.push({
+                            json: response,
+                            pairedItem: { item: i },
+                        });
+                    }
+                    if (operation === 'delete') {
+                        const accountId = this.getNodeParameter('accountId', i);
+                        isValidZohoDeskId(accountId, 'Account ID');
+                        const options = {
+                            method: 'POST',
+                            headers: { orgId },
+                            uri: `${baseUrl}/accounts/moveToTrash`,
+                            body: { accountIds: [accountId] },
+                            json: true,
+                        };
+                        await this.helpers.requestOAuth2.call(this, 'zohoDeskOAuth2Api', options);
+                        returnData.push({
+                            json: { success: true, accountId },
+                            pairedItem: { item: i },
+                        });
+                    }
+                }
+            }
+            catch (error) {
+                // Check for rate limiting (HTTP 429)
+                const errorObj = error;
+                if (errorObj.statusCode === 429 || errorObj.code === 429) {
+                    const rateLimitError = new Error('Zoho Desk API rate limit exceeded (10 requests/second per organization). ' +
+                        'Please wait a moment and try again, or reduce the number of items being processed.');
+                    if (this.continueOnFail()) {
+                        returnData.push({
+                            json: {
+                                error: rateLimitError.message,
+                            },
+                            pairedItem: { item: i },
+                        });
+                        continue;
+                    }
+                    throw rateLimitError;
+                }
+                // Handle other errors
+                if (this.continueOnFail()) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    returnData.push({
+                        json: {
+                            error: errorMessage,
+                        },
+                        pairedItem: { item: i },
+                    });
+                    continue;
+                }
+                throw error;
+            }
+        }
+        return [returnData];
+    }
+}
+exports.ZohoDesk = ZohoDesk;
+//# sourceMappingURL=ZohoDesk.node.js.map