Zoho Desk
Your Toolhouse AI Worker can connect to Zoho Desk using 23 specialized tools.
Auth Connection
This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under Auth Connections.
Tools (23)
Zoho Desk Create Ticket
Zoho Desk Create TicketIntegration name: 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
email
string
"user@example.com"
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
"70931abcde1234fgh"
Optional organization ID header; overrides the default org from auth.
phone
string
"+1234567890"
Phone number associated with the ticket
status
string
"Open"
Status of the ticket
channel
string
"Email"
Channel through which the ticket was created
contact
object
—
Contact information for creating a new contact with the ticket.
dueDate
string
"2024-12-31T23:59:59.000Z"
Due date for the ticket in ISO 8601 format
subject
string
✅
"Unable to login to the portal"
Subject/title of the ticket
category
string
"Technical Issue"
Category of the ticket
priority
string
"High"
Priority level of the ticket
contactId
string
"123456000000015001"
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
"123456000000006915"
ID of the product related to the ticket
assigneeId
string
"123456000000015011"
ID of the agent to assign the ticket to
description
string
"I am unable to login using my credentials. Getting error 403."
Detailed description of the issue or request
subCategory
string
"Login Issues"
Sub-category of the ticket
departmentId
string
✅
"123456000000006907"
ID of the department to which the ticket should be assigned
classification
string
"Question"
Classification of the ticket
Zoho Desk Get Agent
Zoho Desk Get AgentIntegration name: 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
orgId
string
"70931abcde1234fgh"
Optional organization ID header; must match the OAuth token's org.
include
array
["profile"]
List of related resources to include: 'profile', 'role', 'associatedDepartments', 'associatedChatDepartments', 'verifiedEmails'.
agent_id
string
✅
"1234567890"
The Zoho Desk agent ID to retrieve.
Zoho Desk Get Agents Count
Zoho Desk Get Agents CountIntegration name: 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
orgId
string
"70931abcde1234fgh"
Zoho Desk organization ID header. If provided, will be added as 'orgId' header.
status
string
"ACTIVE"
Filter by agent activation status (ACTIVE or DISABLED).
isConfirmed
boolean
true
Filter by confirmation status (true: confirmed agents only).
includeLightAgent
boolean
false
Whether to include light agents in the count.
Zoho Desk Get Contact
Zoho Desk Get ContactIntegration name: 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
orgId
string
"70931abcde1234fgh"
Optional organization ID header; must match the OAuth token's org.
include
array
["accounts"]
List of related resources to include: 'accounts', 'owner'.
contact_id
string
✅
"1234567890"
The Zoho Desk contact ID to retrieve.
Zoho Desk Get Contacts By Ids
Zoho Desk Get Contacts By IdsIntegration name: ZOHO_DESK_GET_CONTACTS_BY_IDS
Tool to fetch multiple contacts by their IDs using Zoho Desk's contactsByIds endpoint.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
ids
array
✅
—
List of up to 20 contact IDs to retrieve (max 20).
orgId
string
"70931abcde1234fgh"
Optional Zoho Desk organization ID header; if provided, must match the OAuth token's organization.
Zoho Desk Get Department
Zoho Desk Get DepartmentIntegration name: ZOHO_DESK_GET_DEPARTMENT
Tool to fetch details of a Zoho Desk department by ID.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
orgId
string
"70931abcde1234fgh"
Optional organization ID header; if provided, must match the OAuth token's organization.
department_id
string
✅
"1139103000000006907"
The Zoho Desk department ID to retrieve.
Zoho Desk Get Department Logo
Zoho Desk Get Department LogoIntegration name: ZOHO_DESK_GET_DEPARTMENT_LOGO
Tool to get/download a department's logo from Zoho Desk.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
orgId
string
"887995567"
Organization ID header. If omitted, the bound org from connection may be used.
file_name
string
"dep_logo.png"
Optional filename to use for the downloaded logo. If not provided, a default name like 'department__logo' will be used.
department_id
string
✅
"1139103000000006907"
The Zoho Desk Department ID.
Zoho Desk Get Departments Count
Zoho Desk Get Departments CountIntegration name: 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
orgId
string
"70931abcde1234fgh"
Zoho Desk organization ID header. If provided, will be added as 'orgId' header.
isEnabled
boolean
true
Filter by department enabled status (true: enabled departments only).
Zoho Desk Get Ticket
Zoho Desk Get TicketIntegration name: ZOHO_DESK_GET_TICKET
Get Ticket
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
orgId
string
"70931abcde1234fgh"
Optional Zoho Desk organization ID; if provided, overrides default.
include
string
"contacts,assignee"
Comma-separated list of related entities to embed. Allowed values: contacts, products, assignee, departments, contract, isRead, team, skills
ticket_id
integer
✅
1234567890
The Zoho Desk ticket ID to fetch.
Zoho Desk Get Ticket Latest Thread
Zoho Desk Get Ticket Latest ThreadIntegration name: 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
orgId
string
"70931abcde1234fgh"
Optional Zoho organization ID; if provided, overrides default.
include
string
"plainText"
Set to 'plainText' to return content in plain text.
ticket_id
integer
✅
1234567890
The Zoho Desk ticket ID to fetch the latest thread for.
needPublic
boolean
true
Whether to return only public threads.
threadStatus
string
"success"
Filter threads by status; allowed values: 'success', 'failed'.
needIncomingThread
boolean
false
Whether to return only incoming threads.
Zoho Desk Get Ticket Resolution
Zoho Desk Get Ticket ResolutionIntegration name: ZOHO_DESK_GET_TICKET_RESOLUTION
Get Ticket Resolution
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
orgId
string
"70931abcde1234fgh"
Optional Zoho Desk organization ID; if provided, will be sent as orgId header.
ticket_id
integer
✅
1234567890
The Zoho Desk ticket ID whose resolution is to be fetched.
Zoho Desk Get Ticket Thread
Zoho Desk Get Ticket ThreadIntegration name: 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
orgId
string
"70931abcde1234fgh"
Optional Zoho Desk organization ID; if provided, overrides default.
include
string
"plainText"
Set to 'plainText' to return the thread content in plain text.
thread_id
integer
✅
9876543210
The ID of the thread to retrieve.
ticket_id
integer
✅
1234567890
The Zoho Desk ticket ID to fetch the thread from.
Zoho Desk List Contact Accounts
Zoho Desk List Contact AccountsIntegration name: ZOHO_DESK_LIST_CONTACT_ACCOUNTS
Tool to list accounts associated with a Zoho Desk contact. Use when you need to retrieve the accounts linked to a specific contact.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
limit
integer
20
Maximum number of accounts to return (1–100).
orgId
string
"70931abcde1234fgh"
Organization ID header; must match the OAuth token's org.
sortBy
string
"-createdTime"
Sort by fields: 'accountName', 'createdTime', or 'mappingType'; prefix with '-' for descending
contact_id
string
✅
"1234567890"
ID of the contact whose accounts to list.
from_index
integer
0
Zero- or one-based index to start listing from. Mapped to query parameter 'from'.
startsWith
string
"A"
Filter by the starting letter(s) of account names.
Zoho Desk List Contacts
Zoho Desk List ContactsIntegration name: 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
limit
integer
20
Number of contacts to fetch (1–100; default: 10)
fields
string
"firstName,lastName,email"
Comma-separated list of up to 30 fields to return
sortBy
string
"-createdTime"
Sort by fields: 'firstName', 'lastName', or 'createdTime'; prefix with '-' for descending
viewId
integer
12345
ID of the view to apply while fetching contacts
include
array
["accounts"]
Secondary information to include; allowed value: 'accounts'
from_index
integer
1
Offset index to start fetching from (default: 1). Mapped to 'from' query parameter.
Zoho Desk List Departments
Zoho Desk List DepartmentsIntegration name: ZOHO_DESK_LIST_DEPARTMENTS
Tool to list all departments in the current Zoho Desk organization.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
orgId
string
"70931abcde1234fgh"
Optional Zoho Desk organization ID header; if provided, must match the OAuth token's organization
Zoho Desk List Organizations
Zoho Desk List OrganizationsIntegration name: 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
orgId
string
"70931abcde1234fgh"
Optional Zoho Desk organization ID header; if provided, must match the OAuth token's organization
Zoho Desk List Roles
Zoho Desk List RolesIntegration name: ZOHO_DESK_LIST_ROLES
List Roles
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
from
integer
—
Start index for pagination (>=0)
limit
integer
—
Number of roles to return (0–500)
orgId
string
"70931abcde1234fgh"
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
Zoho Desk List Roles By Ids
Zoho Desk List Roles By IdsIntegration name: ZOHO_DESK_LIST_ROLES_BY_IDS
List Roles By IDs
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
orgId
string
"70931abcde1234fgh"
Optional Zoho Desk organization ID header; must match OAuth token's org
roleIds
array
✅
—
List of role IDs to retrieve (comma-joined in query; max 50)
Zoho Desk List Teams In Department
Zoho Desk List Teams In DepartmentIntegration name: ZOHO_DESK_LIST_TEAMS_IN_DEPARTMENT
Tool to list teams in the specified Zoho Desk department.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
orgId
string
"887995567"
Optional Zoho Desk organization ID header; if provided, must match the OAuth token's organization
department_id
string
✅
"1139103000000006907"
ID of the department whose teams to list
Zoho Desk List Ticket Conversations
Zoho Desk List Ticket ConversationsIntegration name: ZOHO_DESK_LIST_TICKET_CONVERSATIONS
List Ticket Conversations
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
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
integer
✅
—
ID of the ticket whose conversations are to be listed
Zoho Desk List Tickets
Zoho Desk List TicketsIntegration name: ZOHO_DESK_LIST_TICKETS
List Tickets
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
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
Zoho Desk Update Many Tasks
Zoho Desk Update Many TasksIntegration name: ZOHO_DESK_UPDATE_MANY_TASKS
Update multiple tasks in a single call using Zoho Desk API. Endpoint: POST /api/v1/tasks/updateMany
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
ids
array
✅
—
Array of task IDs to update (max 50)
orgId
string
—
(header) Organization ID of the Zoho Desk account
fieldName
string
✅
—
Name of the field to update
fieldValue
string
—
Value to set for the field
isCustomField
boolean
—
Whether the field is a custom field
Zoho Desk Upload Department Logo
Zoho Desk Upload Department LogoIntegration name: ZOHO_DESK_UPLOAD_DEPARTMENT_LOGO
Tool to upload/update a department logo in Zoho Desk.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
orgId
string
"887995567"
Organization ID header. If omitted, the bound org from connection may be used.
department_id
string
✅
"1139103000000006907"
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
"image/png"
MIME type for the uploaded file (e.g., image/png, image/jpeg, image/gif). Defaults to image/png if not specified.
departmentLogoName
string
"logo.png"
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.