The Zoho Desk connector lets your AI agent act in each user's Zoho Desk account. Each user signs in to Zoho Desk once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 27 tools.
- Tools
- 27
- What they doRead · write · destructive
- 19 · 8 · 019 read8 write0 destructive
- Users sign in with
- OAuth
- OAuth app
- Your own Zoho Desk app
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Zoho Desk connection
In AgentKit > Connections, create a Zoho Desk connection and copy its redirect URI. The name you give it is the
connection_nameyour code passes. See Configure connections.Register an OAuth app
Zoho Desk connections use your own OAuth app. Register one with Zoho Desk and add the redirect URI you copied.
Then enter the app's Client ID and Client Secret on the Zoho Desk connection.
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'zohodesk'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Zoho Desk:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'zohodesk_organizations_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "zohodesk"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Zoho Desk:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="zohodesk_organizations_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolzohodesk_account_getGet one Zoho Desk account (customer company) by ID.Read-onlyGet Account
Get one Zoho Desk account (customer company) by ID. Returns the full account: id, accountName, email, phone, website, industry, address fields, ownerId, custom fields (cf) and webUrl. Use this when you have an account ID. Use zohodesk_account_tickets_list for the account's tickets. Requires an org_id from zohodesk_organizations_list.
Inputs
account_idstringrequired- ID of the account. Get it from zohodesk_accounts_search or zohodesk_accounts_list (id field). Example: 1892000000975382
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
includestring- Set to owner to add the account owner's details. Example: ownerone of
owner
zohodesk_account_tickets_listList the tickets raised by contacts of one Zoho Desk account (customer company).Read-onlyList Account Tickets
List the tickets raised by contacts of one Zoho Desk account (customer company). Returns a data array of tickets, each with id, ticketNumber, subject, status, priority, contactId and createdTime. Use this for a company's ticket history. Use zohodesk_contact_tickets_list for one person's tickets. Requires an org_id from zohodesk_organizations_list.
Inputs
account_idstringrequired- ID of the account. Get it from zohodesk_accounts_search or zohodesk_accounts_list (id field). Example: 1892000000975382
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
department_idstring- ID of the department to list tickets from. Leave empty for all. Example: 1892000000082069
due_datestring- Only tickets due in this window, comma-separated: overdue, today, tomorrow, currentWeek, currentMonth. Example: overdue
frominteger- Zero-based index of the first ticket to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
includestring- Related data to add, comma-separated: contacts, products, departments, team, isRead, assignee. Example: assignee,departments
is_spamboolean- true to return only spam tickets. Defaults to false. Example: false
limitinteger- Number of tickets to return, between 1 and 100. Example: 50
sort_bystring- Sort field: createdTime or modifiedTime. Prefix with - for descending order. Example: -createdTimeone of
createdTime-createdTimemodifiedTime-modifiedTime
zohodesk_accounts_listList accounts (customer companies) in a Zoho Desk organization, sorted and paged.Read-onlyList Accounts
List accounts (customer companies) in a Zoho Desk organization, sorted and paged. Returns a data array of accounts, each with id, accountName, email, phone, website and createdTime. Use this to browse accounts. Use zohodesk_accounts_search to find an account by name, and zohodesk_account_get for one account's full record. Requires an org_id from zohodesk_organizations_list.
Inputs
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
frominteger- Zero-based index of the first account to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
limitinteger- Number of accounts to return, between 1 and 100. Example: 50
sort_bystring- Sort field: accountName or createdTime. Prefix with - for descending order. Default order is ascending. Example: accountNameone of
accountName-accountNamecreatedTime-createdTime view_idstring- ID of a saved account view to apply. Example: 1892000000004563
zohodesk_accounts_searchSearch Zoho Desk accounts (customer companies) by name or any field.Read-onlySearch Accounts
Search Zoho Desk accounts (customer companies) by name or any field. Text fields accept * wildcards. Returns a data array of matching accounts (id, accountName, email, phone, website) and a count. Use this to find an account ID by name. Use zohodesk_accounts_list to browse all accounts. Requires an org_id from zohodesk_organizations_list.
Inputs
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
account_namestring- Name of the account. Supports * wildcards. Example: Zylker*
all_textstring- Text to search across every account field. Supports * wildcards. Example: *zylker*
created_time_rangestring- Created between two ISO 8601 timestamps, as from,to. Example: 2026-01-01T00:00:00.000Z,2026-01-31T23:59:59.000Z
custom_fieldstring- Filter on one custom field, as apiName:value. Example: cf_activeaccount:true
frominteger- Zero-based index of the first result to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
limitinteger- Number of accounts to return, between 1 and 100. Defaults to 10. Example: 50
modified_time_rangestring- Modified between two ISO 8601 timestamps, as from,to. Example: 2026-01-01T00:00:00.000Z,2026-01-31T23:59:59.000Z
sort_bystring- Sort field: relevance, modifiedTime, createdTime or accountName. Prefix with - for descending order. Example: accountNameone of
relevancemodifiedTime-modifiedTimecreatedTime-createdTimeaccountName-accountName
zohodesk_agents_listList agents (help desk staff) in a Zoho Desk organization, optionally filtered by status, department or a name/email search.Read-onlyList Agents
List agents (help desk staff) in a Zoho Desk organization, optionally filtered by status, department or a name/email search. Returns a data array of agents, each with id, firstName, lastName, emailId, status, roleId and associatedDepartmentIds. Use this to find an assignee_id for a ticket. Use zohodesk_current_agent_get for the connected user's own agent record. Requires an org_id from zohodesk_organizations_list.
Inputs
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
department_idsstring- Comma-separated department IDs (up to 50) to return only agents in those departments. Get IDs from zohodesk_departments_list. Example: 1892000000082069,1892000000082085
frominteger- Zero-based index of the first agent to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
limitinteger- Number of agents to return, between 1 and 200. Defaults to 10. Example: 50
search_strstring- Text to match against agent first name, last name or email. End with * for starts-with, wrap in * for contains, or give the exact value. Example: jade*
statusstring- Filter by agent activation status. One of ACTIVE, DISABLED, DELETED, IMPORTED. Example: ACTIVEone of
ACTIVEDISABLEDDELETEDIMPORTED
zohodesk_contact_getGet one Zoho Desk contact by ID.Read-onlyGet Contact
Get one Zoho Desk contact by ID. Returns the full contact: id, firstName, lastName, email, secondaryEmail, phone, mobile, address fields, accountId, ownerId, custom fields (cf) and webUrl. Use this when you have a contact ID. Use zohodesk_contact_tickets_list for the contact's tickets. Requires an org_id from zohodesk_organizations_list.
Inputs
contact_idstringrequired- ID of the contact. Get it from zohodesk_contacts_search or zohodesk_contacts_list (id field). Example: 1892000000042032
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
includestring- Related data to add, comma-separated: accounts, owner. Example: accounts,owner
zohodesk_contact_tickets_listList the tickets raised by one Zoho Desk contact.Read-onlyList Contact Tickets
List the tickets raised by one Zoho Desk contact. Returns a data array of tickets, each with id, ticketNumber, subject, status, priority, departmentId and createdTime. Use this for a customer's ticket history. Use zohodesk_account_tickets_list for every ticket from a company. Requires an org_id from zohodesk_organizations_list.
Inputs
contact_idstringrequired- ID of the contact. Get it from zohodesk_contacts_search or zohodesk_contacts_list (id field). Example: 1892000000042032
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
department_idstring- ID of the department to list tickets from. Leave empty for all. Example: 1892000000082069
due_datestring- Only tickets due in this window, comma-separated: overdue, today, tomorrow, currentWeek, currentMonth. Example: overdue
frominteger- Zero-based index of the first ticket to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
includestring- Related data to add, comma-separated: products, departments, team, isRead, assignee. Example: assignee,departments
is_spamboolean- true to return only spam tickets. Defaults to false. Example: false
limitinteger- Number of tickets to return, between 1 and 100. Example: 50
sort_bystring- Sort field: createdTime or modifiedTime. Prefix with - for descending order. Example: -createdTimeone of
createdTime-createdTimemodifiedTime-modifiedTime
zohodesk_contacts_listList contacts (customers) in a Zoho Desk organization, sorted and paged.Read-onlyList Contacts
List contacts (customers) in a Zoho Desk organization, sorted and paged. Returns a data array of contacts, each with id, firstName, lastName, email, phone, accountId and createdTime. Use this to browse contacts. Use zohodesk_contacts_search to find a contact by name, email or phone, and zohodesk_contact_get for one contact's full record. Requires an org_id from zohodesk_organizations_list.
Inputs
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
frominteger- Zero-based index of the first contact to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
includestring- Set to accounts to add each contact's account details. Example: accountsone of
accounts limitinteger- Number of contacts to return, between 1 and 100. Example: 50
sort_bystring- Sort field: firstName, lastName or createdTime. Prefix with - for descending order. Default order is ascending. Example: -createdTimeone of
firstName-firstNamelastName-lastNamecreatedTime-createdTime view_idstring- ID of a saved contact view to apply. Example: 1892000000004503
zohodesk_contacts_searchSearch Zoho Desk contacts by name, email, phone, account name or any field.Read-onlySearch Contacts
Search Zoho Desk contacts by name, email, phone, account name or any field. Text fields accept * wildcards. Returns a data array of matching contacts (id, firstName, lastName, email, phone, accountId) and a count. Use this to find a contact ID by a known detail. Use zohodesk_contacts_list to browse all contacts. Requires an org_id from zohodesk_organizations_list.
Inputs
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
account_namestring- Name of the contact's account. Supports * wildcards. Example: Zylker*
all_textstring- Text to search across every contact field. Supports * wildcards. Example: *zylker*
created_time_rangestring- Created between two ISO 8601 timestamps, as from,to. Example: 2026-01-01T00:00:00.000Z,2026-01-31T23:59:59.000Z
custom_fieldstring- Filter on one custom field, as apiName:value. Example: cf_mappedwithaccount:true
emailstring- Email address of the contact. Supports * wildcards. Example: carol@zylker.com
first_namestring- First name of the contact. Supports * wildcards. Example: Carol*
frominteger- Zero-based index of the first result to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
full_namestring- Full name of the contact. Supports * wildcards. Example: Carol Smith
last_namestring- Last name of the contact. Supports * wildcards. Example: Smith
limitinteger- Number of contacts to return, between 1 and 100. Defaults to 10. Example: 50
mobilestring- Mobile number of the contact. Supports * wildcards. Example: *9646
modified_time_rangestring- Modified between two ISO 8601 timestamps, as from,to. Example: 2026-01-01T00:00:00.000Z,2026-01-31T23:59:59.000Z
phonestring- Phone number of the contact. Supports * wildcards. Example: *9646
sort_bystring- Sort field: relevance, modifiedTime, createdTime, lastName or firstName. Prefix with - for descending order. Example: -modifiedTimeone of
relevancemodifiedTime-modifiedTimecreatedTime-createdTimelastName-lastNamefirstName-firstName
zohodesk_current_agent_getGet the agent record of the connected Zoho Desk user.Read-onlyGet Current Agent
Get the agent record of the connected Zoho Desk user. Returns id, firstName, lastName, emailId, roleId, profileId and, if requested, associated departments. Use this to find your own agent ID, for example to assign tickets to yourself. Use zohodesk_agents_list for other agents. Requires an org_id from zohodesk_organizations_list.
Inputs
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
includestring- Extra details to add to the response, comma-separated. Allowed: profile, role, associatedDepartments, associatedChatDepartments. Example: profile,role,associatedDepartments
zohodesk_departments_listList departments in a Zoho Desk organization, optionally filtered by enabled state, chat status or a name search.Read-onlyList Departments
List departments in a Zoho Desk organization, optionally filtered by enabled state, chat status or a name search. Returns a data array of departments, each with id, name, description, isEnabled and isDefault. Use this to find the department_id needed to create or search tickets. Requires an org_id from zohodesk_organizations_list.
Inputs
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
chat_statusstring- Filter by the department's chat status. One of AVAILABLE, DISABLED, NOT_CREATED. Example: AVAILABLEone of
AVAILABLEDISABLEDNOT_CREATED frominteger- Zero-based index of the first department to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
is_enabledboolean- Return only enabled departments (true) or only disabled ones (false). Leave empty for all. Example: true
limitinteger- Number of departments to return, between 1 and 200. Defaults to 10. Example: 50
search_strstring- Text to match against department name, help center name or description. End with * for starts-with, wrap in * for contains, or give the exact text for an exact match. Example: Sales*
zohodesk_organizations_listList the Zoho Desk organizations (help desk portals) the connected user belongs to.Read-onlyList Organizations
List the Zoho Desk organizations (help desk portals) the connected user belongs to. Returns a data array of organizations, each with id, companyName, portalName, portalURL, edition and isDefault. Use this first to get the org_id every other Zoho Desk tool needs.
Inputs
This tool takes no inputs.
zohodesk_ticket_comments_listList the comments (agent notes) on a Zoho Desk ticket.Read-onlyList Ticket Comments
List the comments (agent notes) on a Zoho Desk ticket. Returns a data array of comments, each with id, content, isPublic, contentType, commentedTime and commenter. Use this for comments only. Use zohodesk_ticket_conversations_list for comments and email threads together. Requires an org_id from zohodesk_organizations_list.
Inputs
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
ticket_idstringrequired- ID of the ticket. Get it from zohodesk_tickets_list or zohodesk_tickets_search (id field, not ticketNumber). Example: 1892000000143237
frominteger- Zero-based index of the first comment to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
includestring- Extra data, comma-separated: mentions, plainText. Example: plainText
limitinteger- Number of comments to return, between 1 and 100. Defaults to 50. Example: 50default
50 sort_bystring- Sort by comment time: commentedTime for oldest first (the default), -commentedTime for newest first. Example: -commentedTimeone of
commentedTime-commentedTime
zohodesk_ticket_conversations_listList the full conversation on a Zoho Desk ticket: threads (emails and channel messages) and comments together, in one timeline.Read-onlyList Ticket Conversations
List the full conversation on a Zoho Desk ticket: threads (emails and channel messages) and comments together, in one timeline. Returns a data array where each item has a type (thread or comment), id, createdTime and author or commenter, plus summary for threads and content for comments. Use this to read everything that happened on a ticket. Use zohodesk_ticket_threads_list for messages only, or zohodesk_ticket_comments_list for comments only. Requires an org_id from zohodesk_organizations_list.
Inputs
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
ticket_idstringrequired- ID of the ticket. Get it from zohodesk_tickets_list or zohodesk_tickets_search (id field, not ticketNumber). Example: 1892000000143237
frominteger- Zero-based index of the first item to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
limitinteger- Number of items to return, between 1 and 200. Defaults to 100. Example: 50default
100
zohodesk_ticket_getGet one Zoho Desk ticket by ID.Read-onlyGet Ticket
Get one Zoho Desk ticket by ID. Returns the full ticket: id, ticketNumber, subject, description, status, priority, channel, departmentId, contactId, assigneeId, dueDate, custom fields (cf) and webUrl, plus any related data requested in include. Use this when you have a ticket ID. Use zohodesk_ticket_conversations_list to read its replies and comments. Requires an org_id from zohodesk_organizations_list.
Inputs
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
ticket_idstringrequired- ID of the ticket. Get it from zohodesk_tickets_list or zohodesk_tickets_search (id field, not ticketNumber). Example: 1892000000143237
includestring- Related data to add, comma-separated. Allowed: contacts, products, assignee, departments, contract, isRead, team, skills. Example: contacts,assignee,departments
zohodesk_ticket_thread_getGet one thread (email or channel message) on a Zoho Desk ticket, with its full content.Read-onlyGet Ticket Thread
Get one thread (email or channel message) on a Zoho Desk ticket, with its full content. Returns id, channel, direction, content, contentType, from, to, cc, bcc, author, attachments and createdTime. Use this to read a whole message after finding it with zohodesk_ticket_threads_list. Requires an org_id from zohodesk_organizations_list.
Inputs
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
thread_idstringrequired- ID of the thread. Get it from zohodesk_ticket_threads_list (id field). Example: 1892000000135387
ticket_idstringrequired- ID of the ticket. Get it from zohodesk_tickets_list or zohodesk_tickets_search (id field, not ticketNumber). Example: 1892000000143237
includestring- Set to plainText to also return the content as plain text. Example: plainTextone of
plainText
zohodesk_ticket_threads_listList the threads on a Zoho Desk ticket: the emails, replies and other channel messages, newest first by default.Read-onlyList Ticket Threads
List the threads on a Zoho Desk ticket: the emails, replies and other channel messages, newest first by default. Returns a data array of threads, each with id, channel, direction (in or out), summary, from and to addresses, author and createdTime. Bodies are summarized. Use this for the message history only. Use zohodesk_ticket_conversations_list for threads and comments together, and zohodesk_ticket_thread_get for one thread's full content. Requires an org_id from zohodesk_organizations_list.
Inputs
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
ticket_idstringrequired- ID of the ticket. Get it from zohodesk_tickets_list or zohodesk_tickets_search (id field, not ticketNumber). Example: 1892000000143237
frominteger- Zero-based index of the first thread to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
limitinteger- Number of threads to return, between 1 and 200. Defaults to 100. Example: 50default
100 sort_bystring- Sort by send time: sendDateTime for oldest first, -sendDateTime for newest first (the default). Example: sendDateTimeone of
sendDateTime-sendDateTime
zohodesk_tickets_listList tickets in a Zoho Desk organization, with filters for department, assignee, status, priority and channel, sorted and paged.Read-onlyList Tickets
List tickets in a Zoho Desk organization, with filters for department, assignee, status, priority and channel, sorted and paged. Returns a data array of tickets, each with id, ticketNumber, subject, status, priority, departmentId, contactId, assigneeId, createdTime and webUrl. Use this to browse tickets by fixed filters. Use zohodesk_tickets_search for a text or wildcard search, and zohodesk_ticket_get for one ticket's full record. Requires an org_id from zohodesk_organizations_list.
Inputs
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
assigneestring- Agent ID(s) the tickets are assigned to, comma-separated, or Unassigned for tickets with no agent. Get agent IDs from zohodesk_agents_list. Example: 1892000000056007
channelstring- Channel(s) the ticket came in through, comma-separated, such as Email, Phone, Web, Chat or Forums. Example: Email
department_idsstring- Comma-separated department IDs to list tickets from. Get IDs from zohodesk_departments_list. Leave empty for the default department view. Example: 1892000000082069
frominteger- Zero-based index of the first ticket to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
includestring- Related data to add to each ticket, comma-separated. Allowed: contacts, products, assignee, departments, isRead, team. Example: contacts,assignee
limitinteger- Number of tickets to return, between 1 and 100. Example: 50
prioritystring- Ticket priority name(s), comma-separated, such as High, Medium or Low (custom values also work). Example: High
sort_bystring- Field to sort by: createdTime, responseDueDate or customerResponseTime. Prefix with - for descending order. Default order is ascending. Example: -createdTimeone of
createdTime-createdTimeresponseDueDate-responseDueDatecustomerResponseTime-customerResponseTime statusstring- Ticket status name(s), comma-separated. System values are Open, On Hold, Escalated and Closed; custom statuses also work. Example: Open,On Hold
view_idstring- ID of a saved ticket view to apply. Example: 1892000000004445
zohodesk_tickets_searchSearch Zoho Desk tickets by text or by field values such as subject, ticket number, email, contact, account, status or date ranges.Read-onlySearch Tickets
Search Zoho Desk tickets by text or by field values such as subject, ticket number, email, contact, account, status or date ranges. Text fields accept * wildcards. Returns a data array of matching tickets (id, ticketNumber, subject, status, priority, contactId, departmentId, createdTime) and a count. Use this to find tickets by keyword or a specific value. Use zohodesk_tickets_list to browse by department, assignee or status only. Requires an org_id from zohodesk_organizations_list.
Inputs
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
account_idstring- ID of the account linked to the ticket. Get it from zohodesk_accounts_search. Example: 1892000000975382
account_namestring- Name of the account linked to the ticket. Supports * wildcards. Example: Zylker*
all_textstring- Text to search across every ticket field. Supports * wildcards. Example: *refund*
assignee_idstring- ID of the agent assigned to the ticket. Get it from zohodesk_agents_list. Example: 1892000000056007
categorystring- Ticket category. Supports * wildcards. Example: general
contact_idstring- ID of the contact who raised the ticket. Get it from zohodesk_contacts_search. Example: 1892000000042032
contact_namestring- Name of the contact who raised the ticket. Supports * wildcards. Example: Carol*
created_time_rangestring- Created between two ISO 8601 timestamps, as from,to. Example: 2026-01-01T00:00:00.000Z,2026-01-31T23:59:59.000Z
custom_fieldstring- Filter on one custom field, as apiName:value. Supports * wildcards. Example: cf_modelname:F3*
department_idstring- ID of the department to search in. Leave empty to search all departments you can access. Example: 1892000000082069
due_date_rangestring- Due between two ISO 8601 timestamps, as from,to. Example: 2026-01-01T00:00:00.000Z,2026-01-31T23:59:59.000Z
emailstring- Email address on the ticket. Supports * wildcards. Example: carol@zylker.com
frominteger- Zero-based index of the first result to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
limitinteger- Number of tickets to return, between 1 and 100. Defaults to 10. Example: 50
modified_time_rangestring- Modified between two ISO 8601 timestamps, as from,to. Example: 2026-01-01T00:00:00.000Z,2026-01-31T23:59:59.000Z
prioritystring- Exact priority, such as High, Medium or Low. Example: High
sort_bystring- Sort field: relevance, modifiedTime, createdTime or customerResponseTime. Prefix with - for descending order. Example: -modifiedTimeone of
relevancemodifiedTime-modifiedTimecreatedTime-createdTimecustomerResponseTime-customerResponseTime statusstring- Status name(s), comma-separated, including custom statuses. Example: Open,On Hold
subjectstring- Text to match in the ticket subject. Supports * wildcards. Example: analysis*
tagstring- Tag on the ticket. Supports * wildcards. Example: billing
ticket_numberstring- Exact ticket number shown to agents and customers (not the internal id). Example: 773
zohodesk_account_createCreate an account (customer company) in Zoho Desk.WriteCreate Account
Create an account (customer company) in Zoho Desk. Returns the new account with id, accountName, email, phone, website and webUrl. Use this to add a company that contacts can be linked to. Use zohodesk_account_update to change an existing account. Requires an org_id from zohodesk_organizations_list.
Inputs
account_namestringrequired- Name of the account (company), up to 200 characters. Example: Zylker Inc
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
annual_revenuenumber- Annual revenue of the account. Example: 2500000
cfobject- Custom field values as an object keyed by each field's API name (they start with cf_). Example: {"cf_activeaccount": "true"}
citystring- City. Example: Pleasanton
codestring- ZIP or postal code. Example: 94588
countrystring- Country. Example: United States
descriptionstring- Short description of the account. Example: Enterprise customer since 2019.
emailstring- Email address of the account. Example: support@zylker.com
faxstring- Fax number of the account. Example: 6218129191
industrystring- Industry the account operates in. Example: Technology
owner_idstring- ID of the agent who owns the account. Get it from zohodesk_agents_list. Example: 1892000000042001
phonestring- Phone number of the account. Example: 6218129190
statestring- State or region. Example: California
streetstring- Street address. Example: 4900 Hopyard Rd
websitestring- Website of the account. Example: https://www.zylker.com
zohodesk_account_updateUpdate fields on a Zoho Desk account.WriteUpdate Account
Update fields on a Zoho Desk account. Only the fields you pass change. Returns the updated account with id, accountName, email, phone, website and modifiedTime. Use this to correct or enrich an account. Use zohodesk_account_create to add a new one. Requires an org_id from zohodesk_organizations_list.
- Idempotent
Inputs
account_idstringrequired- ID of the account. Get it from zohodesk_accounts_search or zohodesk_accounts_list (id field). Example: 1892000000975382
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
account_namestring- Name of the account (company), up to 200 characters. Example: Zylker Inc
annual_revenuenumber- Annual revenue of the account. Example: 2500000
cfobject- Custom field values as an object keyed by each field's API name (they start with cf_). Example: {"cf_activeaccount": "true"}
citystring- City. Example: Pleasanton
codestring- ZIP or postal code. Example: 94588
countrystring- Country. Example: United States
descriptionstring- Short description of the account. Example: Enterprise customer since 2019.
emailstring- Email address of the account. Example: support@zylker.com
faxstring- Fax number of the account. Example: 6218129191
industrystring- Industry the account operates in. Example: Technology
owner_idstring- ID of the agent who owns the account. Get it from zohodesk_agents_list. Example: 1892000000042001
phonestring- Phone number of the account. Example: 6218129190
statestring- State or region. Example: California
streetstring- Street address. Example: 4900 Hopyard Rd
websitestring- Website of the account. Example: https://www.zylker.com
zohodesk_contact_createCreate a contact (customer) in Zoho Desk, optionally linked to an account.WriteCreate Contact
Create a contact (customer) in Zoho Desk, optionally linked to an account. Returns the new contact with id, firstName, lastName, email, accountId and webUrl. Use this to add a customer before raising tickets for them. Use zohodesk_contact_update to change an existing contact. Requires an org_id from zohodesk_organizations_list.
Inputs
last_namestringrequired- Last name of the contact, up to 200 characters. Example: Smith
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
account_idstring- ID of the account (company) the contact belongs to. Get it from zohodesk_accounts_search. Example: 1892000000975382
cfobject- Custom field values as an object keyed by each field's API name (they start with cf_). Example: {"cf_permanentaddress": "Pleasanton"}
citystring- City. Example: Pleasanton
countrystring- Country. Example: United States
descriptionstring- Notes about the contact. Example: Prefers phone calls.
emailstring- Primary email address. Example: carol@zylker.com
first_namestring- First name of the contact. Example: Carol
languagestring- Preferred language. Example: English
mobilestring- Mobile number. Example: +1 555 010 2030
owner_idstring- ID of the agent who owns the contact. Get it from zohodesk_agents_list. Example: 1892000000042001
phonestring- Phone number. Example: 1 888 900 9646
secondary_emailstring- Secondary email address. Example: carol.smith@gmail.com
statestring- State or region. Example: California
streetstring- Street address. Example: 4900 Hopyard Rd
titlestring- Job title. Example: Purchase Manager
typestring- Contact type label used in the help desk. Example: Paid User
zipstring- ZIP or postal code. Example: 94588
zohodesk_contact_updateUpdate fields on a Zoho Desk contact.WriteUpdate Contact
Update fields on a Zoho Desk contact. Only the fields you pass change. Returns the updated contact with id, firstName, lastName, email, phone, accountId and modifiedTime. Use this to correct or enrich a contact. Use zohodesk_contact_create to add a new one. Requires an org_id from zohodesk_organizations_list.
- Idempotent
Inputs
contact_idstringrequired- ID of the contact. Get it from zohodesk_contacts_search or zohodesk_contacts_list (id field). Example: 1892000000042032
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
account_idstring- ID of the account (company) the contact belongs to. Get it from zohodesk_accounts_search. Example: 1892000000975382
cfobject- Custom field values as an object keyed by each field's API name (they start with cf_). Example: {"cf_permanentaddress": "Pleasanton"}
citystring- City. Example: Pleasanton
countrystring- Country. Example: United States
descriptionstring- Notes about the contact. Example: Prefers phone calls.
emailstring- Primary email address. Example: carol@zylker.com
first_namestring- First name of the contact. Example: Carol
languagestring- Preferred language. Example: English
last_namestring- Last name of the contact, up to 200 characters. Example: Smith
mobilestring- Mobile number. Example: +1 555 010 2030
owner_idstring- ID of the agent who owns the contact. Get it from zohodesk_agents_list. Example: 1892000000042001
phonestring- Phone number. Example: 1 888 900 9646
secondary_emailstring- Secondary email address. Example: carol.smith@gmail.com
statestring- State or region. Example: California
streetstring- Street address. Example: 4900 Hopyard Rd
titlestring- Job title. Example: Purchase Manager
typestring- Contact type label used in the help desk. Example: Paid User
zipstring- ZIP or postal code. Example: 94588
zohodesk_ticket_comment_addAdd a comment to a Zoho Desk ticket.WriteAdd Ticket Comment
Add a comment to a Zoho Desk ticket. Comments are private notes for agents unless is_public is true, and are never emailed to the customer. Returns the comment with id, content, isPublic, contentType, commentedTime and commenter. Use this for internal notes and agent mentions. Use zohodesk_ticket_reply_send to reply to the customer. Requires an org_id from zohodesk_organizations_list.
Inputs
contentstringrequired- Comment text, up to 32000 characters. HTML by default. To mention an agent write zsu[@user:{zuid}]zsu. Example: Escalating to the billing team.
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
ticket_idstringrequired- ID of the ticket. Get it from zohodesk_tickets_list or zohodesk_tickets_search (id field, not ticketNumber). Example: 1892000000143237
content_typestring- Format of content: html (the default) or plainText. Example: plainTextone of
htmlplainText is_publicboolean- true to show the comment to the customer in the help center; false (the default) keeps it private to agents. Example: false
zohodesk_ticket_createCreate a ticket in a Zoho Desk department for an existing contact, or create the contact at the same time.WriteCreate Ticket
Create a ticket in a Zoho Desk department for an existing contact, or create the contact at the same time. Returns the new ticket with id, ticketNumber, subject, status, statusType, departmentId, contactId and webUrl. Use this to log a new support request. Use zohodesk_ticket_update to change an existing ticket. Requires an org_id from zohodesk_organizations_list and a department_id from zohodesk_departments_list.
Inputs
department_idstringrequired- ID of the department the ticket belongs to. Get it from zohodesk_departments_list. Example: 1892000000006907
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
subjectstringrequired- Subject line of the ticket, up to 255 characters. Example: Real time analysis requirement
assignee_idstring- ID of the agent to assign the ticket to. Get it from zohodesk_agents_list. Example: 1892000000056007
categorystring- Category of the ticket. Example: general
cfobject- Custom field values as an object keyed by each field's API name (they start with cf_). Example: {"cf_modelname": "F3 2017"}
channelstring- Channel the ticket came in through, such as Email, Phone, Web, Chat or Forums. Example: Email
classificationstring- Ticket classification, such as Problem, Request or Question, or a custom value. Example: Problem
contactobject- Contact to create (or match by email) when you have no contact_id. An object with at least lastName or email; firstName and phone are optional. If the email already exists, that contact is used. Example: {"lastName": "Carol", "email": "carol@zylker.com"}
contact_idstring- ID of an existing contact who raised the ticket. Get it from zohodesk_contacts_search. Give either contact_id or contact. Example: 1892000000042032
descriptionstring- Body of the ticket. HTML is allowed. Example: The dashboard stops refreshing after 5 minutes.
due_datestring- Due date as an ISO 8601 timestamp. Example: 2026-06-21T16:16:16.000Z
emailstring- Email address for the ticket. Example: carol@zylker.com
languagestring- Language of the ticket. Example: English
phonestring- Phone number for the ticket. Example: 1 888 900 9646
prioritystring- Ticket priority, such as High, Medium or Low, or a custom value. Example: High
product_idstring- ID of the product the ticket is about. Example: 1892000000094004
resolutionstring- Resolution notes for the ticket. Example: Cleared the browser cache.
statusstring- Ticket status, such as Open, On Hold, Escalated or Closed, or a custom status. Example: Open
sub_categorystring- Subcategory of the ticket. Example: Sub General
team_idstring- ID of the team to assign the ticket to. Example: 1892000000057006
zohodesk_ticket_reply_sendSend a reply on a Zoho Desk ticket to the customer by email (or the ticket's social or forum channel), optionally changing the ticket status.WriteSend Ticket Reply
Send a reply on a Zoho Desk ticket to the customer by email (or the ticket's social or forum channel), optionally changing the ticket status. Returns the new thread with id, channel, direction, content summary, to, fromEmailAddress and status. Use this to answer the customer. Use zohodesk_ticket_comment_add for an internal note that is not emailed. Requires an org_id from zohodesk_organizations_list. For email, fromEmailAddress must be a support address configured in the help desk.
Inputs
channelstringrequired- Channel to reply through. Use EMAIL for email tickets; FACEBOOK, TWITTER and FORUMS reply on those channels. Example: EMAILone of
EMAILFACEBOOKTWITTERFORUMS contentstringrequired- Body of the reply. Plain text by default; set content_type to html for HTML. Example: We have identified the root cause and fixed it.
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
ticket_idstringrequired- ID of the ticket. Get it from zohodesk_tickets_list or zohodesk_tickets_search (id field, not ticketNumber). Example: 1892000000143237
bccstring- Email address(es) to blind-copy, comma-separated. EMAIL replies only. Example: audit@zylker.com
ccstring- Email address(es) to copy, comma-separated. EMAIL replies only. Example: lead@zylker.com
content_typestring- Format of content for EMAIL replies: plainText (the default) or html. Example: htmlone of
plainTexthtml from_email_addressstring- Support address to send from. Required for EMAIL replies and must be a from address configured in the help desk. Example: techsupport@zylker.com
in_reply_to_thread_idstring- ID of the thread this reply answers, from zohodesk_ticket_threads_list. EMAIL replies only. Example: 1892000001080004
ticket_statusstring- Status to set on the ticket after replying, such as Closed or On Hold, or a custom status. Example: Closed
tostring- Recipient email address(es) for EMAIL replies, comma-separated. Example: carol@zylker.com
zohodesk_ticket_updateUpdate fields on a Zoho Desk ticket, such as status, priority, assignee, department or custom fields.WriteUpdate Ticket
Update fields on a Zoho Desk ticket, such as status, priority, assignee, department or custom fields. Only the fields you pass change. Returns the updated ticket with id, ticketNumber, subject, status, priority, assigneeId and modifiedTime. Use this to triage, reassign or close a ticket. Use zohodesk_ticket_reply_send to answer the customer. Requires an org_id from zohodesk_organizations_list.
- Idempotent
Inputs
org_idstringrequired- ID of the Zoho Desk organization (help desk portal) to act on, sent as the orgId header. Get it from zohodesk_organizations_list (id field). Example: 2389290
ticket_idstringrequired- ID of the ticket. Get it from zohodesk_tickets_list or zohodesk_tickets_search (id field, not ticketNumber). Example: 1892000000143237
assignee_idstring- ID of the agent to assign the ticket to. Get it from zohodesk_agents_list. Example: 1892000000056007
categorystring- Category of the ticket. Example: general
cfobject- Custom field values as an object keyed by each field's API name (they start with cf_). Example: {"cf_modelname": "F3 2017"}
channelstring- Channel the ticket came in through, such as Email, Phone, Web, Chat or Forums. Example: Email
classificationstring- Ticket classification, such as Problem, Request or Question, or a custom value. Example: Problem
contact_idstring- ID of the contact to link the ticket to. Get it from zohodesk_contacts_search. Example: 1892000000042032
department_idstring- ID of the department the ticket belongs to. Get it from zohodesk_departments_list. Example: 1892000000006907
descriptionstring- Body of the ticket. HTML is allowed. Example: The dashboard stops refreshing after 5 minutes.
due_datestring- Due date as an ISO 8601 timestamp. Example: 2026-06-21T16:16:16.000Z
emailstring- Email address for the ticket. Example: carol@zylker.com
languagestring- Language of the ticket. Example: English
phonestring- Phone number for the ticket. Example: 1 888 900 9646
prioritystring- Ticket priority, such as High, Medium or Low, or a custom value. Example: High
product_idstring- ID of the product the ticket is about. Example: 1892000000094004
resolutionstring- Resolution notes for the ticket. Example: Cleared the browser cache.
statusstring- Ticket status, such as Open, On Hold, Escalated or Closed, or a custom status. Example: Open
sub_categorystring- Subcategory of the ticket. Example: Sub General
subjectstring- Subject line of the ticket, up to 255 characters. Example: Real time analysis requirement
team_idstring- ID of the team to assign the ticket to. Example: 1892000000057006
No tools match.