> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Zoho Desk

> Zoho Desk is a context-aware helpdesk platform enabling support teams to track tickets, automate workflows, and gain insights on customer interactions

![Zoho Desk logo](https://mintcdn.com/composio-preview/11RkPhDhzt1wdr6a/images/toolkits/zoho_desk.svg?fit=max\&auto=format\&n=11RkPhDhzt1wdr6a\&q=85\&s=8942328db3ec03192fcd49b5ec1a48e6)

* **Category:** crm
* **Auth:** OAUTH2
* **Composio-managed OAuth available?** Yes
* **Tools:** 36
* **Triggers:** 0
* **Slug:** `ZOHO_DESK`
* **Version:** 20261103\_00

## Tools

> [accordion] Create Contact
>
> **Slug:** `ZOHO_DESK_CREATE_CONTACT`
>
> Tool to create a new contact in Zoho Desk with name, email, and other details. Use this action when you need to add a new contact to the system, such as when onboarding a new customer or registering a support requester. Returns the created contact with id and webUrl for downstream operations.
>
> #### Input Parameters
>
> **zip** `string`
>
> Zip or postal code
>
> **city** `string`
>
> City
>
> **type** `string`
>
> Type or category of the contact
>
> **email** `string`
>
> Primary email address of the contact
>
> **orgId** `string`
>
> Optional organization ID header; overrides the default org from auth
>
> **phone** `string`
>
> Phone number
>
> **state** `string`
>
> State or province
>
> **title** `string`
>
> Job title or position of the contact
>
> **mobile** `string`
>
> Mobile number
>
> **street** `string`
>
> Street address
>
> **country** `string`
>
> Country
>
> **ownerId** `string`
>
> ID of the user who will own this contact
>
> **language** `string`
>
> Preferred language for communication
>
> **lastName** `string` *required*
>
> Last name of the contact (required)
>
> **accountId** `string`
>
> ID of the account to associate this contact with
>
> **firstName** `string` *required*
>
> First name of the contact (required)
>
> **description** `string`
>
> Description or notes about the contact
>
> **secondaryEmail** `string`
>
> Secondary email address
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Ticket
>
> **Slug:** `ZOHO_DESK_CREATE_TICKET`
>
> Tool to create a new Zoho Desk ticket with subject, description, department, and requester details. Use when you need to create a support ticket in Zoho Desk. Returns the created ticket with id and webUrl for downstream chaining.
>
> #### Input Parameters
>
> **email** `string`
>
> Email address of the requester. Use this if you don't have a contactId. Zoho Desk will look up or create a contact with this email. Mutually exclusive with 'contactId'.
>
> **orgId** `string`
>
> Optional organization ID header; overrides the default org from auth.
>
> **phone** `string`
>
> Phone number associated with the ticket
>
> **status** `string`
>
> Status of the ticket
>
> **channel** `string`
>
> Channel through which the ticket was created
>
> **contact** `object`
>
> Contact information for creating a new contact with the ticket.
>
> **dueDate** `string`
>
> Due date for the ticket in ISO 8601 format
>
> **subject** `string` *required*
>
> Subject/title of the ticket
>
> **category** `string`
>
> Category of the ticket
>
> **priority** `string`
>
> Priority level of the ticket
>
> **contactId** `string`
>
> ID of an existing contact who is submitting the ticket. Use this if you already know the contact ID. Mutually exclusive with 'email' and 'contact'.
>
> **productId** `string`
>
> ID of the product related to the ticket
>
> **assigneeId** `string`
>
> ID of the agent to assign the ticket to
>
> **description** `string`
>
> Detailed description of the issue or request
>
> **subCategory** `string`
>
> Sub-category of the ticket
>
> **departmentId** `string` *required*
>
> ID of the department to which the ticket should be assigned
>
> **classification** `string`
>
> Classification of the ticket
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download Ticket Attachment
>
> **Slug:** `ZOHO_DESK_DOWNLOAD_TICKET_ATTACHMENT`
>
> Download a file attachment from a Zoho Desk ticket by attachment ID. Use this action when you need to retrieve a specific file that was previously attached to a ticket. Requires both the ticket ID and the attachment ID to identify the file to download.
>
> #### Input Parameters
>
> **orgId** `string`
>
> Organization ID header. If omitted, the bound org from connection may be used.
>
> **file\_name** `string`
>
> Optional filename to use for the downloaded attachment. If not provided, a default name like 'ticket\_\{ticket\_id}*attachment*\{attachment\_id}' will be used.
>
> **ticket\_id** `string` *required*
>
> The ID of the ticket containing the attachment.
>
> **attachment\_id** `string` *required*
>
> The ID of the attachment to download.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Account
>
> **Slug:** `ZOHO_DESK_GET_ACCOUNT`
>
> Retrieve one Zoho Desk customer account by its account ID.
>
> #### Input Parameters
>
> **org\_id** `string`
>
> Optional Zoho Desk organization ID sent in the orgId header
>
> **account\_id** `string` *required*
>
> Numeric ID of the account to retrieve
>
> **include\_owner** `boolean`
>
> Whether to include the account owner's details
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Agent
>
> **Slug:** `ZOHO_DESK_GET_AGENT`
>
> Tool to fetch details of a Zoho Desk agent. Use when you have an agent ID and need its full data, optionally including related resources.
>
> #### Input Parameters
>
> **orgId** `string`
>
> Optional organization ID header; must match the OAuth token's org.
>
> **include** `array`
>
> List of related resources to include: 'profile', 'role', 'associatedDepartments', 'associatedChatDepartments', 'verifiedEmails'.
>
> **agent\_id** `string` *required*
>
> The Zoho Desk agent ID to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Agents Count
>
> **Slug:** `ZOHO_DESK_GET_AGENTS_COUNT`
>
> Tool to get the total count of agents in Zoho Desk. Use when you need the number of agents optionally filtered by status, confirmation, or light agents.
>
> #### Input Parameters
>
> **orgId** `string`
>
> Zoho Desk organization ID header. If provided, will be added as 'orgId' header.
>
> **status** `string ("ACTIVE" | "DISABLED")`
>
> Filter by agent activation status (ACTIVE or DISABLED).
>
> **isConfirmed** `boolean`
>
> Filter by confirmation status (true: confirmed agents only).
>
> **includeLightAgent** `boolean`
>
> Whether to include light agents in the count.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Contact
>
> **Slug:** `ZOHO_DESK_GET_CONTACT`
>
> Tool to fetch details of a Zoho Desk contact. Use when you have a contact ID and need its full data, optionally including accounts or owner details.
>
> #### Input Parameters
>
> **orgId** `string`
>
> Optional organization ID header; must match the OAuth token's org.
>
> **include** `array`
>
> List of related resources to include: 'accounts', 'owner'.
>
> **contact\_id** `string` *required*
>
> The Zoho Desk contact ID to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Contacts By IDs
>
> **Slug:** `ZOHO_DESK_GET_CONTACTS_BY_IDS`
>
> Tool to fetch multiple contacts by their IDs using Zoho Desk's contactsByIds endpoint.
>
> #### Input Parameters
>
> **ids** `array` *required*
>
> List of up to 20 contact IDs to retrieve (max 20).
>
> **orgId** `string`
>
> Optional Zoho Desk organization ID header; if provided, must match the OAuth token's organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Department
>
> **Slug:** `ZOHO_DESK_GET_DEPARTMENT`
>
> Tool to fetch details of a Zoho Desk department by ID.
>
> #### Input Parameters
>
> **orgId** `string`
>
> Optional organization ID header; if provided, must match the OAuth token's organization.
>
> **department\_id** `string` *required*
>
> The Zoho Desk department ID to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Department Logo
>
> **Slug:** `ZOHO_DESK_GET_DEPARTMENT_LOGO`
>
> Tool to get/download a department's logo from Zoho Desk.
>
> #### Input Parameters
>
> **orgId** `string`
>
> Organization ID header. If omitted, the bound org from connection may be used.
>
> **file\_name** `string`
>
> Optional filename to use for the downloaded logo. If not provided, a default name like 'department\_\<id>\_logo' will be used.
>
> **department\_id** `string` *required*
>
> The Zoho Desk Department ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Departments Count
>
> **Slug:** `ZOHO_DESK_GET_DEPARTMENTS_COUNT`
>
> Tool to get the total count of departments in Zoho Desk. Use when you need the number of departments, optionally filtered by enabled status.
>
> #### Input Parameters
>
> **orgId** `string`
>
> Zoho Desk organization ID header. If provided, will be added as 'orgId' header.
>
> **isEnabled** `boolean`
>
> Filter by department enabled status (true: enabled departments only).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Ticket
>
> **Slug:** `ZOHO_DESK_GET_TICKET`
>
> Get Ticket
>
> #### Input Parameters
>
> **orgId** `string`
>
> Optional Zoho Desk organization ID; if provided, overrides default.
>
> **include** `string`
>
> Comma-separated list of related entities to embed. Allowed values: contacts, products, assignee, departments, contract, isRead, team, skills
>
> **ticket\_id** `string` *required*
>
> The Zoho Desk ticket ID to fetch. Pass it as a string to preserve all digits.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Ticket Latest Thread
>
> **Slug:** `ZOHO_DESK_GET_TICKET_LATEST_THREAD`
>
> Tool to fetch the most recent thread of a ticket. Use when you need the latest conversation on a ticket.
>
> #### Input Parameters
>
> **orgId** `string`
>
> Optional Zoho organization ID; if provided, overrides default.
>
> **include** `string`
>
> Set to 'plainText' to return content in plain text.
>
> **ticket\_id** `string` *required*
>
> The Zoho Desk ticket ID to fetch the latest thread for. Pass it as a string to preserve all digits.
>
> **needPublic** `boolean`
>
> Whether to return only public threads.
>
> **threadStatus** `string ("success" | "failed")`
>
> Filter threads by status; allowed values: 'success', 'failed'.
>
> **needIncomingThread** `boolean`
>
> Whether to return only incoming threads.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Ticket Resolution
>
> **Slug:** `ZOHO_DESK_GET_TICKET_RESOLUTION`
>
> Get Ticket Resolution
>
> #### Input Parameters
>
> **orgId** `string`
>
> Optional Zoho Desk organization ID; if provided, will be sent as orgId header.
>
> **ticket\_id** `string` *required*
>
> The Zoho Desk ticket ID whose resolution is to be fetched. Pass it as a string to preserve all digits.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Ticket Thread
>
> **Slug:** `ZOHO_DESK_GET_TICKET_THREAD`
>
> Tool to fetch a specific thread within a Zoho Desk ticket. Use when you need detailed thread information by ticket and thread IDs.
>
> #### Input Parameters
>
> **orgId** `string`
>
> Optional Zoho Desk organization ID; if provided, overrides default.
>
> **include** `string`
>
> Set to 'plainText' to return the thread content in plain text.
>
> **thread\_id** `string` *required*
>
> The ID of the thread to retrieve. Pass it as a string to preserve all digits.
>
> **ticket\_id** `string` *required*
>
> The Zoho Desk ticket ID to fetch the thread from. Pass it as a string to preserve all digits.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Agents
>
> **Slug:** `ZOHO_DESK_LIST_AGENTS`
>
> Tool to list all agents in the Zoho Desk organization with optional filtering and pagination. Use when you need to retrieve multiple agents, optionally filtered by status or confirmation state.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Number of agents to return per request (1-50; default: 25)
>
> **orgId** `string`
>
> Optional Zoho Desk organization ID header; if provided, must match the OAuth token's organization
>
> **status** `string ("ACTIVE" | "DISABLED")`
>
> Filter by agent activation status (ACTIVE or DISABLED)
>
> **include** `array`
>
> List of related resources to include: 'profile', 'role'
>
> **from\_index** `integer`
>
> Starting index for pagination (default: 0)
>
> **isConfirmed** `boolean`
>
> Filter by confirmation status (true: confirmed agents only)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Contact Accounts
>
> **Slug:** `ZOHO_DESK_LIST_CONTACT_ACCOUNTS`
>
> Lists accounts associated with a Zoho Desk contact. If license access to the account listing is limited, a fallback may return at most one account or an empty list, rather than the full set of associated accounts.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of accounts to return (1–100).
>
> **orgId** `string`
>
> Organization ID header; must match the OAuth token's org.
>
> **sortBy** `string`
>
> Sort by fields: 'accountName', 'createdTime', or 'mappingType'; prefix with '-' for descending
>
> **contact\_id** `string` *required*
>
> ID of the contact whose accounts to list.
>
> **from\_index** `integer`
>
> Zero- or one-based index to start listing from. Mapped to query parameter 'from'.
>
> **startsWith** `string`
>
> Filter by the starting letter(s) of account names.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Contacts
>
> **Slug:** `ZOHO_DESK_LIST_CONTACTS`
>
> Tool to list contacts with filters and pagination. Use when you need to fetch contacts from Zoho Desk with optional filtering, sorting, or field selection.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Number of contacts to fetch (1–100; default: 10)
>
> **fields** `string`
>
> Comma-separated list of up to 30 fields to return
>
> **sortBy** `string`
>
> Sort by fields: 'firstName', 'lastName', or 'createdTime'; prefix with '-' for descending
>
> **viewId** `string`
>
> ID of the view to apply while fetching contacts. Pass it as a string to preserve all digits.
>
> **include** `array`
>
> Secondary information to include; allowed value: 'accounts'
>
> **from\_index** `integer`
>
> Offset index to start fetching from (default: 1). Mapped to 'from' query parameter.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Contact Tickets
>
> **Slug:** `ZOHO_DESK_LIST_CONTACT_TICKETS`
>
> List one offset-limited page of tickets raised by a Zoho Desk contact. Use from\_index and limit to select the page.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of tickets to return (1-100)
>
> **org\_id** `string`
>
> Optional Zoho Desk organization ID sent in the orgId header
>
> **is\_spam** `boolean`
>
> Filter tickets by spam status
>
> **sort\_by** `string ("createdTime" | "-createdTime" | "modifiedTime" | "-modifiedTime")`
>
> Sort by created or modified time; prefix the value with - for descending order
>
> **contact\_id** `string` *required*
>
> Numeric ID of the contact whose tickets are requested
>
> **from\_index** `integer`
>
> Zero-based offset sent as the from query parameter
>
> **department\_id** `string`
>
> Numeric department ID used to restrict returned tickets
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Departments
>
> **Slug:** `ZOHO_DESK_LIST_DEPARTMENTS`
>
> List departments in the current Zoho Desk organization. Returns the API's default page of up to 10 departments.
>
> #### Input Parameters
>
> **orgId** `string`
>
> Optional Zoho Desk organization ID header; if provided, must match the OAuth token's organization
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Organizations
>
> **Slug:** `ZOHO_DESK_LIST_ORGANIZATIONS`
>
> Tool to list all organizations the current user belongs to. Use when you need to retrieve organization metadata like portal URLs, names, and editions.
>
> #### Input Parameters
>
> **orgId** `string`
>
> Optional Zoho Desk organization ID header; if provided, must match the OAuth token's organization
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Roles
>
> **Slug:** `ZOHO_DESK_LIST_ROLES`
>
> List Roles
>
> #### Input Parameters
>
> **from** `integer`
>
> Start index for pagination (>=0)
>
> **limit** `integer`
>
> Number of roles to return (0–500)
>
> **orgId** `string`
>
> Optional Zoho Desk organization ID header; must match OAuth token's org
>
> **isDefault** `boolean`
>
> Filter default vs custom roles
>
> **isVisible** `boolean`
>
> Filter by UI visibility
>
> **searchStr** `string`
>
> Search by name/description; supports string\*, *string*, exact; max 100 chars
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Roles By IDs
>
> **Slug:** `ZOHO_DESK_LIST_ROLES_BY_IDS`
>
> List Roles By IDs
>
> #### Input Parameters
>
> **orgId** `string`
>
> Optional Zoho Desk organization ID header; must match OAuth token's org
>
> **roleIds** `array` *required*
>
> List of role IDs to retrieve (comma-joined in query; max 50)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Teams in Department
>
> **Slug:** `ZOHO_DESK_LIST_TEAMS_IN_DEPARTMENT`
>
> Tool to list teams in the specified Zoho Desk department.
>
> #### Input Parameters
>
> **orgId** `string`
>
> Optional Zoho Desk organization ID header; if provided, must match the OAuth token's organization
>
> **department\_id** `string` *required*
>
> ID of the department whose teams to list
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Ticket Comments
>
> **Slug:** `ZOHO_DESK_LIST_TICKET_COMMENTS`
>
> List comments recorded on a Zoho Desk ticket. Returns one offset-limited page; from\_index and limit control the page.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of comments to return (1-100)
>
> **org\_id** `string`
>
> Optional Zoho Desk organization ID sent in the orgId header
>
> **include** `array`
>
> Related comment representations to include: mentions, plainText, or both
>
> **sort\_by** `string ("commentedTime" | "-commentedTime")`
>
> Sort by comment time: commentedTime for ascending or -commentedTime for descending; omission uses the provider default
>
> **ticket\_id** `string` *required*
>
> Numeric ID of the ticket whose comments are requested
>
> **from\_index** `integer`
>
> Zero-based offset sent as the from query parameter
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Ticket Conversations
>
> **Slug:** `ZOHO_DESK_LIST_TICKET_CONVERSATIONS`
>
> List Ticket Conversations
>
> #### Input Parameters
>
> **from** `integer`
>
> Starting index from which conversations are fetched; range: >= 0
>
> **limit** `integer`
>
> Number of conversations to fetch; range: 1–200; default decided by API
>
> **orgId** `string`
>
> Zoho Desk organization ID to be passed in orgId header
>
> **ticket\_id** `string` *required*
>
> ID of the ticket whose conversations are to be listed. Pass it as a string to preserve all digits.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Ticket History
>
> **Slug:** `ZOHO_DESK_LIST_TICKET_HISTORY`
>
> List audit and activity history for a ticket. History records describe ticket changes and actions. Use the conversation or thread actions instead when you need message and comment content.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of history events to return (1-50)
>
> **org\_id** `string`
>
> Optional Zoho Desk organization ID sent in the orgId header
>
> **agent\_id** `string`
>
> Numeric agent ID used to filter history events
>
> **ticket\_id** `string` *required*
>
> Numeric ID of the ticket whose history is requested
>
> **field\_name** `string`
>
> Ticket field name used to filter history events
>
> **from\_index** `integer`
>
> Zero-based offset sent as the from query parameter
>
> **event\_filter** `string`
>
> Provider-defined history category sent as eventFilter, such as CommentHistory, AttachmentHistory, WorkflowHistory, or ZiaRelatedHistory
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Tickets
>
> **Slug:** `ZOHO_DESK_LIST_TICKETS`
>
> List Tickets
>
> #### Input Parameters
>
> **from** `integer`
>
> Offset index to start fetching from (default: 1)
>
> **limit** `integer`
>
> Number of tickets to fetch (1–100; default: 10)
>
> **orgId** `string`
>
> Organization ID header
>
> **viewId** `string`
>
> View ID to filter tickets
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Ticket Threads
>
> **Slug:** `ZOHO_DESK_LIST_TICKET_THREADS`
>
> List message threads recorded on a Zoho Desk ticket. This returns threads only. Use the conversations action when comments and threads should be returned together.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of threads to return (1-200)
>
> **org\_id** `string`
>
> Optional Zoho Desk organization ID sent in the orgId header
>
> **sort\_by** `string ("sendDateTime" | "-sendDateTime")`
>
> Sort by send time: sendDateTime for ascending or -sendDateTime for descending; omission uses the provider default
>
> **ticket\_id** `string` *required*
>
> Numeric ID of the ticket whose threads are requested
>
> **from\_index** `integer`
>
> Zero-based offset sent as the from query parameter
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Views
>
> **Slug:** `ZOHO_DESK_LIST_VIEWS`
>
> List all ticket views in the Zoho Desk organization with pagination support. Views are saved filters that help organize and display tickets based on specific criteria. Use this action when you need to retrieve available views for filtering tickets, such as before calling the list tickets endpoint with a specific viewId.
>
> #### Input Parameters
>
> **from** `integer`
>
> Offset index to start fetching from (default: 1)
>
> **limit** `integer`
>
> Number of views to fetch per page (1-100; default: 25)
>
> **orgId** `string`
>
> Optional Zoho Desk organization ID header; if provided, must match the OAuth token's organization
>
> **module** `string` *required*
>
> The module to list views for. Common values: 'tickets', 'contacts', 'accounts', 'tasks', 'calls', 'events'
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search
>
> **Slug:** `ZOHO_DESK_SEARCH`
>
> Search Zoho Desk tickets, accounts, contacts, and tasks by keyword or phrase, across all modules or within a selected module. Filter by department, sort by relevance or modified time, and paginate matching results.
>
> #### Input Parameters
>
> **from** `integer`
>
> Pagination offset to start fetching results from (default: 1)
>
> **limit** `integer`
>
> Number of results to return (default: 25, maximum: 50)
>
> **orgId** `string`
>
> Optional organization ID header; overrides the default org from auth
>
> **module** `string ("tickets" | "accounts" | "contacts" | "tasks")`
>
> Enum for searchable modules in Zoho Desk.
>
> **sortBy** `string ("relevance" | "modifiedTime")`
>
> Enum for sort options in search results.
>
> **searchStr** `string`
>
> Keyword or phrase to search for across modules
>
> **departmentId** `string`
>
> Filter results by department ID
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Account
>
> **Slug:** `ZOHO_DESK_UPDATE_ACCOUNT`
>
> Tool to update an existing Zoho Desk account's information such as name, email, phone, website, or description. Use this action when you need to modify account details after the account has been created. Only the fields you provide will be updated; other fields remain unchanged.
>
> #### Input Parameters
>
> **email** `string`
>
> Email address associated with the account.
>
> **orgId** `string`
>
> Optional organization ID header; must match the OAuth token's org.
>
> **phone** `string`
>
> Phone number of the account.
>
> **website** `string`
>
> Website URL of the account.
>
> **account\_id** `string` *required*
>
> The Zoho Desk account ID to update.
>
> **accountName** `string`
>
> Name of the account or company.
>
> **description** `string`
>
> Description or notes about the account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Many Tasks
>
> **Slug:** `ZOHO_DESK_UPDATE_MANY_TASKS`
>
> Update one field across multiple Zoho Desk tasks in a single call, for up to 50 task IDs. Results report success or errors for each task.
>
> #### Input Parameters
>
> **ids** `array` *required*
>
> Array of task IDs to update as strings to preserve all digits (max 50)
>
> **orgId** `string`
>
> (header) Organization ID of the Zoho Desk account
>
> **fieldName** `string` *required*
>
> Name of the field to update
>
> **fieldValue** `string`
>
> Value to set for the field
>
> **isCustomField** `boolean`
>
> Whether the field is a custom field
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Ticket
>
> **Slug:** `ZOHO_DESK_UPDATE_TICKET`
>
> Updates an existing Zoho Desk ticket by modifying provided fields such as status, priority, assignee, or description. Returns the updated ticket's supported fields.
>
> #### Input Parameters
>
> **orgId** `string`
>
> Optional organization ID header; overrides the default org from auth
>
> **phone** `string`
>
> Updated phone number associated with the ticket
>
> **status** `string`
>
> Updated status of the ticket
>
> **channel** `string`
>
> Updated channel through which the ticket was created
>
> **dueDate** `string`
>
> Updated due date for the ticket in ISO 8601 format
>
> **subject** `string`
>
> Updated subject/title of the ticket
>
> **category** `string`
>
> Updated category of the ticket
>
> **priority** `string`
>
> Updated priority level of the ticket
>
> **contactId** `string`
>
> ID of the contact associated with the ticket
>
> **productId** `string`
>
> ID of the product related to the ticket
>
> **ticket\_id** `string` *required*
>
> The ID of the ticket to update
>
> **assigneeId** `string`
>
> ID of the agent to assign or reassign the ticket to
>
> **description** `string`
>
> Updated detailed description of the issue or request
>
> **subCategory** `string`
>
> Updated sub-category of the ticket
>
> **departmentId** `string`
>
> ID of the department to which the ticket should be assigned
>
> **classification** `string`
>
> Updated classification of the ticket
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Department Logo
>
> **Slug:** `ZOHO_DESK_UPLOAD_DEPARTMENT_LOGO`
>
> Tool to upload/update a department logo in Zoho Desk.
>
> #### Input Parameters
>
> **orgId** `string`
>
> Organization ID header. If omitted, the bound org from connection may be used.
>
> **department\_id** `string` *required*
>
> The Zoho Desk Department ID.
>
> **departmentLogo** `object`
>
> File to upload as department logo (jpg, jpeg, png, gif; max 2 MB). This will be sent as multipart form field named 'departmentLogo'.
>
> **departmentLogoMime** `string`
>
> MIME type for the uploaded file (e.g., image/png, image/jpeg, image/gif). Defaults to image/png if not specified.
>
> **departmentLogoName** `string`
>
> Filename to use when uploading (used if Base64 content is provided).
>
> **departmentLogoBase64** `string`
>
> Base64-encoded image content to upload as the department logo. If provided, it will be decoded and sent as 'departmentLogo' multipart field.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Ticket Attachment
>
> **Slug:** `ZOHO_DESK_UPLOAD_TICKET_ATTACHMENT`
>
> Uploads a file attachment to a specific Zoho Desk ticket. The uploaded file becomes accessible as an attachment within the ticket for support agents and customers to reference. Use this action when you need to attach documentation, screenshots, logs, or any supporting files to an existing ticket. Maximum file size is 20 MB per attachment.
>
> #### Input Parameters
>
> **file** `object` *required*
>
> File to upload as ticket attachment. Provide an uploaded file or file URL. Maximum file size is 20 MB.
>
> **orgId** `string`
>
> Organization ID header. If omitted, the bound org from connection may be used.
>
> **ticketId** `string` *required*
>
> The ID of the ticket to upload the attachment to
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
