Zoho Desk is a context-aware helpdesk platform enabling support teams to track tickets, automate workflows, and gain insights on customer interactions
Zoho Desk is a context-aware helpdesk platform enabling support teams to track tickets, automate workflows, and gain insights on customer interactions On Nagent, Zoho Desk is exposed as a fully-configurable crm integration that any agent can call — 23 actions, and OAuth authentication. No code is required to wire Zoho Desk into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Zoho Desk to automate the kinds of tasks crm teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Zoho Desk into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Zoho Desk, with input parameters and output schema. Drop these into any step of an agent built in Helix.
ZOHO_DESK_CREATE_TICKETTool 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 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'.
Optional organization ID header; overrides the default org from auth.
Phone number associated with the ticket
Status of the ticket
Channel through which the ticket was created
Contact information for creating a new contact with the ticket.
Due date for the ticket in ISO 8601 format
Subject/title of the ticket
Category of the ticket
Priority level of the ticket
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'.
ID of the product related to the ticket
ID of the agent to assign the ticket to
Detailed description of the issue or request
Sub-category of the ticket
ID of the department to which the ticket should be assigned
Classification of the ticket
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_GET_AGENTTool 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
Optional organization ID header; must match the OAuth token's org.
List of related resources to include: 'profile', 'role', 'associatedDepartments', 'associatedChatDepartments', 'verifiedEmails'.
The Zoho Desk agent ID to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_GET_AGENTS_COUNTTool 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
Zoho Desk organization ID header. If provided, will be added as 'orgId' header.
Filter by agent activation status (ACTIVE or DISABLED).
Filter by confirmation status (true: confirmed agents only).
Whether to include light agents in the count.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_GET_CONTACTTool 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
Optional organization ID header; must match the OAuth token's org.
List of related resources to include: 'accounts', 'owner'.
The Zoho Desk contact ID to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_GET_CONTACTS_BY_IDSTool to fetch multiple contacts by their IDs using Zoho Desk's contactsByIds endpoint.
Input parameters
List of up to 20 contact IDs to retrieve (max 20).
Optional Zoho Desk organization ID header; if provided, must match the OAuth token's organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_GET_DEPARTMENTTool to fetch details of a Zoho Desk department by ID.
Input parameters
Optional organization ID header; if provided, must match the OAuth token's organization.
The Zoho Desk department ID to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_GET_DEPARTMENT_LOGOTool to get/download a department's logo from Zoho Desk.
Input parameters
Organization ID header. If omitted, the bound org from connection may be used.
Optional filename to use for the downloaded logo. If not provided, a default name like 'department_<id>_logo' will be used.
The Zoho Desk Department ID.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_GET_DEPARTMENTS_COUNTTool 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
Zoho Desk organization ID header. If provided, will be added as 'orgId' header.
Filter by department enabled status (true: enabled departments only).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_GET_TICKETGet Ticket
Input parameters
Optional Zoho Desk organization ID; if provided, overrides default.
Comma-separated list of related entities to embed. Allowed values: contacts, products, assignee, departments, contract, isRead, team, skills
The Zoho Desk ticket ID to fetch.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_GET_TICKET_LATEST_THREADTool to fetch the most recent thread of a ticket. Use when you need the latest conversation on a ticket.
Input parameters
Optional Zoho organization ID; if provided, overrides default.
Set to 'plainText' to return content in plain text.
The Zoho Desk ticket ID to fetch the latest thread for.
Whether to return only public threads.
Filter threads by status; allowed values: 'success', 'failed'.
Whether to return only incoming threads.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_GET_TICKET_RESOLUTIONGet Ticket Resolution
Input parameters
Optional Zoho Desk organization ID; if provided, will be sent as orgId header.
The Zoho Desk ticket ID whose resolution is to be fetched.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_GET_TICKET_THREADTool to fetch a specific thread within a Zoho Desk ticket. Use when you need detailed thread information by ticket and thread IDs.
Input parameters
Optional Zoho Desk organization ID; if provided, overrides default.
Set to 'plainText' to return the thread content in plain text.
The ID of the thread to retrieve.
The Zoho Desk ticket ID to fetch the thread from.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_LIST_CONTACT_ACCOUNTSTool to list accounts associated with a Zoho Desk contact. Use when you need to retrieve the accounts linked to a specific contact.
Input parameters
Maximum number of accounts to return (1–100).
Organization ID header; must match the OAuth token's org.
Sort by fields: 'accountName', 'createdTime', or 'mappingType'; prefix with '-' for descending
ID of the contact whose accounts to list.
Zero- or one-based index to start listing from. Mapped to query parameter 'from'.
Filter by the starting letter(s) of account names.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_LIST_CONTACTSTool 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
Number of contacts to fetch (1–100; default: 10)
Comma-separated list of up to 30 fields to return
Sort by fields: 'firstName', 'lastName', or 'createdTime'; prefix with '-' for descending
ID of the view to apply while fetching contacts
Secondary information to include; allowed value: 'accounts'
Offset index to start fetching from (default: 1). Mapped to 'from' query parameter.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_LIST_DEPARTMENTSTool to list all departments in the current Zoho Desk organization.
Input parameters
Optional Zoho Desk organization ID header; if provided, must match the OAuth token's organization
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_LIST_ORGANIZATIONSTool 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
Optional Zoho Desk organization ID header; if provided, must match the OAuth token's organization
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_LIST_ROLESList Roles
Input parameters
Start index for pagination (>=0)
Number of roles to return (0–500)
Optional Zoho Desk organization ID header; must match OAuth token's org
Filter default vs custom roles
Filter by UI visibility
Search by name/description; supports string*, *string*, exact; max 100 chars
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_LIST_ROLES_BY_IDSList Roles By IDs
Input parameters
Optional Zoho Desk organization ID header; must match OAuth token's org
List of role IDs to retrieve (comma-joined in query; max 50)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_LIST_TEAMS_IN_DEPARTMENTTool to list teams in the specified Zoho Desk department.
Input parameters
Optional Zoho Desk organization ID header; if provided, must match the OAuth token's organization
ID of the department whose teams to list
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_LIST_TICKET_CONVERSATIONSList Ticket Conversations
Input parameters
Starting index from which conversations are fetched; range: >= 0
Number of conversations to fetch; range: 1–200; default decided by API
Zoho Desk organization ID to be passed in orgId header
ID of the ticket whose conversations are to be listed
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_LIST_TICKETSList Tickets
Input parameters
Offset index to start fetching from (default: 1)
Number of tickets to fetch (1–100; default: 10)
Organization ID header
View ID to filter tickets
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_UPDATE_MANY_TASKSUpdate multiple tasks in a single call using Zoho Desk API. Endpoint: POST /api/v1/tasks/updateMany
Input parameters
Array of task IDs to update (max 50)
(header) Organization ID of the Zoho Desk account
Name of the field to update
Value to set for the field
Whether the field is a custom field
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ZOHO_DESK_UPLOAD_DEPARTMENT_LOGOTool to upload/update a department logo in Zoho Desk.
Input parameters
Organization ID header. If omitted, the bound org from connection may be used.
The Zoho Desk Department ID.
File to upload as department logo (jpg, jpeg, png, gif; max 2 MB). This will be sent as multipart form field named 'departmentLogo'.
MIME type for the uploaded file (e.g., image/png, image/jpeg, image/gif). Defaults to image/png if not specified.
Filename to use when uploading (used if Base64 content is provided).
Base64-encoded image content to upload as the department logo. If provided, it will be decoded and sent as 'departmentLogo' multipart field.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 54 agents privately built on Nagent that already use Zoho Desk.
Build on Nagent
Connect Zoho Desk to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Zoho Desk, and click "Connect Now." You'll authenticate with OAuth — Nagent handles credential storage and refresh automatically. Once connected, Zoho Desk is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Zoho Desk is connected, you configure its 23 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Zoho Desk steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Zoho Desk event fires, the agent kicks off automatically.
Every Zoho Desk action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Zoho Desk ships with 23 pre-built crm actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Zoho Desk together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Zoho Desk-based workflows tailored to your business.