> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Zoho Desk

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.

**Authentication:** OAuth 2.0
**Categories:** Customer Support
**Tools:** 27: 19 read, 8 write, 0 destructive
**Users sign in with:** OAuth
**OAuth app:** Your own Zoho Desk app
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=ZOHODESK)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### 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_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### 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.

5. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   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.actions

   const connector = 'zohodesk'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { 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 call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'zohodesk_organizations_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_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.actions

   connection_name = "zohodesk"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_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 call
   result = actions.execute_tool(
       tool_input={},
       tool_name="zohodesk_organizations_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user signs in once. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'zohodesk_account_get',
  toolInput: {
    account_id: '<account_id>',
    org_id: '<org_id>',
  },
  connector: 'zohodesk',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="zohodesk_account_get",
    tool_input={
        "account_id": "<account_id>",
        "org_id": "<org_id>",
    },
    connection_name="zohodesk",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `zohodesk_account_get`

Get Account · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_id` (`string`, required): ID of the account. Get it from zohodesk_accounts_search or zohodesk_accounts_list (id field). Example: 1892000000975382
- `org_id` (`string`, required): 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
- `include` (`string`, optional): Set to owner to add the account owner's details. Example: owner. One of: `owner`.

Example input: `{"account_id":"<account_id>","org_id":"<org_id>"}`

### `zohodesk_account_tickets_list`

List Account Tickets · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_id` (`string`, required): ID of the account. Get it from zohodesk_accounts_search or zohodesk_accounts_list (id field). Example: 1892000000975382
- `org_id` (`string`, required): 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_id` (`string`, optional): ID of the department to list tickets from. Leave empty for all. Example: 1892000000082069
- `due_date` (`string`, optional): Only tickets due in this window, comma-separated: overdue, today, tomorrow, currentWeek, currentMonth. Example: overdue
- `from` (`integer`, optional): Zero-based index of the first ticket to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
- `include` (`string`, optional): Related data to add, comma-separated: contacts, products, departments, team, isRead, assignee. Example: assignee,departments
- `is_spam` (`boolean`, optional): true to return only spam tickets. Defaults to false. Example: false
- `limit` (`integer`, optional): Number of tickets to return, between 1 and 100. Example: 50
- `sort_by` (`string`, optional): Sort field: createdTime or modifiedTime. Prefix with - for descending order. Example: -createdTime. One of: `createdTime`, `-createdTime`, `modifiedTime`, `-modifiedTime`.

Example input: `{"account_id":"<account_id>","org_id":"<org_id>"}`

### `zohodesk_accounts_list`

List Accounts · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_id` (`string`, required): 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
- `from` (`integer`, optional): Zero-based index of the first account to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
- `limit` (`integer`, optional): Number of accounts to return, between 1 and 100. Example: 50
- `sort_by` (`string`, optional): Sort field: accountName or createdTime. Prefix with - for descending order. Default order is ascending. Example: accountName. One of: `accountName`, `-accountName`, `createdTime`, `-createdTime`.
- `view_id` (`string`, optional): ID of a saved account view to apply. Example: 1892000000004563

Example input: `{"org_id":"<org_id>"}`

### `zohodesk_accounts_search`

Search Accounts · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_id` (`string`, required): 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_name` (`string`, optional): Name of the account. Supports * wildcards. Example: Zylker*
- `all_text` (`string`, optional): Text to search across every account field. Supports * wildcards. Example: *zylker*
- `created_time_range` (`string`, optional): Created between two ISO 8601 timestamps, as from,to. Example: 2026-01-01T00:00:00.000Z,2026-01-31T23:59:59.000Z
- `custom_field` (`string`, optional): Filter on one custom field, as apiName:value. Example: cf_activeaccount:true
- `from` (`integer`, optional): Zero-based index of the first result to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
- `limit` (`integer`, optional): Number of accounts to return, between 1 and 100. Defaults to 10. Example: 50
- `modified_time_range` (`string`, optional): Modified between two ISO 8601 timestamps, as from,to. Example: 2026-01-01T00:00:00.000Z,2026-01-31T23:59:59.000Z
- `sort_by` (`string`, optional): Sort field: relevance, modifiedTime, createdTime or accountName. Prefix with - for descending order. Example: accountName. One of: `relevance`, `modifiedTime`, `-modifiedTime`, `createdTime`, `-createdTime`, `accountName`, `-accountName`.

Example input: `{"org_id":"<org_id>"}`

### `zohodesk_agents_list`

List Agents · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_id` (`string`, required): 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_ids` (`string`, optional): Comma-separated department IDs (up to 50) to return only agents in those departments. Get IDs from zohodesk_departments_list. Example: 1892000000082069,1892000000082085
- `from` (`integer`, optional): Zero-based index of the first agent to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
- `limit` (`integer`, optional): Number of agents to return, between 1 and 200. Defaults to 10. Example: 50
- `search_str` (`string`, optional): 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*
- `status` (`string`, optional): Filter by agent activation status. One of ACTIVE, DISABLED, DELETED, IMPORTED. Example: ACTIVE. One of: `ACTIVE`, `DISABLED`, `DELETED`, `IMPORTED`.

Example input: `{"org_id":"<org_id>"}`

### `zohodesk_contact_get`

Get Contact · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`string`, required): ID of the contact. Get it from zohodesk_contacts_search or zohodesk_contacts_list (id field). Example: 1892000000042032
- `org_id` (`string`, required): 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
- `include` (`string`, optional): Related data to add, comma-separated: accounts, owner. Example: accounts,owner

Example input: `{"contact_id":"<contact_id>","org_id":"<org_id>"}`

### `zohodesk_contact_tickets_list`

List Contact Tickets · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`string`, required): ID of the contact. Get it from zohodesk_contacts_search or zohodesk_contacts_list (id field). Example: 1892000000042032
- `org_id` (`string`, required): 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_id` (`string`, optional): ID of the department to list tickets from. Leave empty for all. Example: 1892000000082069
- `due_date` (`string`, optional): Only tickets due in this window, comma-separated: overdue, today, tomorrow, currentWeek, currentMonth. Example: overdue
- `from` (`integer`, optional): Zero-based index of the first ticket to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
- `include` (`string`, optional): Related data to add, comma-separated: products, departments, team, isRead, assignee. Example: assignee,departments
- `is_spam` (`boolean`, optional): true to return only spam tickets. Defaults to false. Example: false
- `limit` (`integer`, optional): Number of tickets to return, between 1 and 100. Example: 50
- `sort_by` (`string`, optional): Sort field: createdTime or modifiedTime. Prefix with - for descending order. Example: -createdTime. One of: `createdTime`, `-createdTime`, `modifiedTime`, `-modifiedTime`.

Example input: `{"contact_id":"<contact_id>","org_id":"<org_id>"}`

### `zohodesk_contacts_list`

List Contacts · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_id` (`string`, required): 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
- `from` (`integer`, optional): Zero-based index of the first contact to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
- `include` (`string`, optional): Set to accounts to add each contact's account details. Example: accounts. One of: `accounts`.
- `limit` (`integer`, optional): Number of contacts to return, between 1 and 100. Example: 50
- `sort_by` (`string`, optional): Sort field: firstName, lastName or createdTime. Prefix with - for descending order. Default order is ascending. Example: -createdTime. One of: `firstName`, `-firstName`, `lastName`, `-lastName`, `createdTime`, `-createdTime`.
- `view_id` (`string`, optional): ID of a saved contact view to apply. Example: 1892000000004503

Example input: `{"org_id":"<org_id>"}`

### `zohodesk_contacts_search`

Search Contacts · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_id` (`string`, required): 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_name` (`string`, optional): Name of the contact's account. Supports * wildcards. Example: Zylker*
- `all_text` (`string`, optional): Text to search across every contact field. Supports * wildcards. Example: *zylker*
- `created_time_range` (`string`, optional): Created between two ISO 8601 timestamps, as from,to. Example: 2026-01-01T00:00:00.000Z,2026-01-31T23:59:59.000Z
- `custom_field` (`string`, optional): Filter on one custom field, as apiName:value. Example: cf_mappedwithaccount:true
- `email` (`string`, optional): Email address of the contact. Supports * wildcards. Example: carol@zylker.com
- `first_name` (`string`, optional): First name of the contact. Supports * wildcards. Example: Carol*
- `from` (`integer`, optional): 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_name` (`string`, optional): Full name of the contact. Supports * wildcards. Example: Carol Smith
- `last_name` (`string`, optional): Last name of the contact. Supports * wildcards. Example: Smith
- `limit` (`integer`, optional): Number of contacts to return, between 1 and 100. Defaults to 10. Example: 50
- `mobile` (`string`, optional): Mobile number of the contact. Supports * wildcards. Example: *9646
- `modified_time_range` (`string`, optional): Modified between two ISO 8601 timestamps, as from,to. Example: 2026-01-01T00:00:00.000Z,2026-01-31T23:59:59.000Z
- `phone` (`string`, optional): Phone number of the contact. Supports * wildcards. Example: *9646
- `sort_by` (`string`, optional): Sort field: relevance, modifiedTime, createdTime, lastName or firstName. Prefix with - for descending order. Example: -modifiedTime. One of: `relevance`, `modifiedTime`, `-modifiedTime`, `createdTime`, `-createdTime`, `lastName`, `-lastName`, `firstName`, `-firstName`.

Example input: `{"org_id":"<org_id>"}`

### `zohodesk_current_agent_get`

Get Current Agent · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_id` (`string`, required): 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
- `include` (`string`, optional): Extra details to add to the response, comma-separated. Allowed: profile, role, associatedDepartments, associatedChatDepartments. Example: profile,role,associatedDepartments

Example input: `{"org_id":"<org_id>"}`

### `zohodesk_departments_list`

List Departments · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_id` (`string`, required): 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_status` (`string`, optional): Filter by the department's chat status. One of AVAILABLE, DISABLED, NOT_CREATED. Example: AVAILABLE. One of: `AVAILABLE`, `DISABLED`, `NOT_CREATED`.
- `from` (`integer`, optional): 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_enabled` (`boolean`, optional): Return only enabled departments (true) or only disabled ones (false). Leave empty for all. Example: true
- `limit` (`integer`, optional): Number of departments to return, between 1 and 200. Defaults to 10. Example: 50
- `search_str` (`string`, optional): 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*

Example input: `{"org_id":"<org_id>"}`

### `zohodesk_organizations_list`

List Organizations · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `zohodesk_ticket_comments_list`

List Ticket Comments · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_id` (`string`, required): 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_id` (`string`, required): ID of the ticket. Get it from zohodesk_tickets_list or zohodesk_tickets_search (id field, not ticketNumber). Example: 1892000000143237
- `from` (`integer`, optional): Zero-based index of the first comment to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
- `include` (`string`, optional): Extra data, comma-separated: mentions, plainText. Example: plainText
- `limit` (`integer`, optional): Number of comments to return, between 1 and 100. Defaults to 50. Example: 50. Default: `50`.
- `sort_by` (`string`, optional): Sort by comment time: commentedTime for oldest first (the default), -commentedTime for newest first. Example: -commentedTime. One of: `commentedTime`, `-commentedTime`.

Example input: `{"org_id":"<org_id>","ticket_id":"<ticket_id>"}`

### `zohodesk_ticket_conversations_list`

List Ticket Conversations · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_id` (`string`, required): 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_id` (`string`, required): ID of the ticket. Get it from zohodesk_tickets_list or zohodesk_tickets_search (id field, not ticketNumber). Example: 1892000000143237
- `from` (`integer`, optional): Zero-based index of the first item to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
- `limit` (`integer`, optional): Number of items to return, between 1 and 200. Defaults to 100. Example: 50. Default: `100`.

Example input: `{"org_id":"<org_id>","ticket_id":"<ticket_id>"}`

### `zohodesk_ticket_get`

Get Ticket · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_id` (`string`, required): 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_id` (`string`, required): ID of the ticket. Get it from zohodesk_tickets_list or zohodesk_tickets_search (id field, not ticketNumber). Example: 1892000000143237
- `include` (`string`, optional): Related data to add, comma-separated. Allowed: contacts, products, assignee, departments, contract, isRead, team, skills. Example: contacts,assignee,departments

Example input: `{"org_id":"<org_id>","ticket_id":"<ticket_id>"}`

### `zohodesk_ticket_thread_get`

Get Ticket Thread · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_id` (`string`, required): 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_id` (`string`, required): ID of the thread. Get it from zohodesk_ticket_threads_list (id field). Example: 1892000000135387
- `ticket_id` (`string`, required): ID of the ticket. Get it from zohodesk_tickets_list or zohodesk_tickets_search (id field, not ticketNumber). Example: 1892000000143237
- `include` (`string`, optional): Set to plainText to also return the content as plain text. Example: plainText. One of: `plainText`.

Example input: `{"org_id":"<org_id>","thread_id":"<thread_id>","ticket_id":"<ticket_id>"}`

### `zohodesk_ticket_threads_list`

List Ticket Threads · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_id` (`string`, required): 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_id` (`string`, required): ID of the ticket. Get it from zohodesk_tickets_list or zohodesk_tickets_search (id field, not ticketNumber). Example: 1892000000143237
- `from` (`integer`, optional): Zero-based index of the first thread to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
- `limit` (`integer`, optional): Number of threads to return, between 1 and 200. Defaults to 100. Example: 50. Default: `100`.
- `sort_by` (`string`, optional): Sort by send time: sendDateTime for oldest first, -sendDateTime for newest first (the default). Example: sendDateTime. One of: `sendDateTime`, `-sendDateTime`.

Example input: `{"org_id":"<org_id>","ticket_id":"<ticket_id>"}`

### `zohodesk_tickets_list`

List Tickets · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_id` (`string`, required): 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
- `assignee` (`string`, optional): 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
- `channel` (`string`, optional): Channel(s) the ticket came in through, comma-separated, such as Email, Phone, Web, Chat or Forums. Example: Email
- `department_ids` (`string`, optional): Comma-separated department IDs to list tickets from. Get IDs from zohodesk_departments_list. Leave empty for the default department view. Example: 1892000000082069
- `from` (`integer`, optional): Zero-based index of the first ticket to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
- `include` (`string`, optional): Related data to add to each ticket, comma-separated. Allowed: contacts, products, assignee, departments, isRead, team. Example: contacts,assignee
- `limit` (`integer`, optional): Number of tickets to return, between 1 and 100. Example: 50
- `priority` (`string`, optional): Ticket priority name(s), comma-separated, such as High, Medium or Low (custom values also work). Example: High
- `sort_by` (`string`, optional): Field to sort by: createdTime, responseDueDate or customerResponseTime. Prefix with - for descending order. Default order is ascending. Example: -createdTime. One of: `createdTime`, `-createdTime`, `responseDueDate`, `-responseDueDate`, `customerResponseTime`, `-customerResponseTime`.
- `status` (`string`, optional): Ticket status name(s), comma-separated. System values are Open, On Hold, Escalated and Closed; custom statuses also work. Example: Open,On Hold
- `view_id` (`string`, optional): ID of a saved ticket view to apply. Example: 1892000000004445

Example input: `{"org_id":"<org_id>"}`

### `zohodesk_tickets_search`

Search Tickets · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_id` (`string`, required): 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_id` (`string`, optional): ID of the account linked to the ticket. Get it from zohodesk_accounts_search. Example: 1892000000975382
- `account_name` (`string`, optional): Name of the account linked to the ticket. Supports * wildcards. Example: Zylker*
- `all_text` (`string`, optional): Text to search across every ticket field. Supports * wildcards. Example: *refund*
- `assignee_id` (`string`, optional): ID of the agent assigned to the ticket. Get it from zohodesk_agents_list. Example: 1892000000056007
- `category` (`string`, optional): Ticket category. Supports * wildcards. Example: general
- `contact_id` (`string`, optional): ID of the contact who raised the ticket. Get it from zohodesk_contacts_search. Example: 1892000000042032
- `contact_name` (`string`, optional): Name of the contact who raised the ticket. Supports * wildcards. Example: Carol*
- `created_time_range` (`string`, optional): Created between two ISO 8601 timestamps, as from,to. Example: 2026-01-01T00:00:00.000Z,2026-01-31T23:59:59.000Z
- `custom_field` (`string`, optional): Filter on one custom field, as apiName:value. Supports * wildcards. Example: cf_modelname:F3*
- `department_id` (`string`, optional): ID of the department to search in. Leave empty to search all departments you can access. Example: 1892000000082069
- `due_date_range` (`string`, optional): Due between two ISO 8601 timestamps, as from,to. Example: 2026-01-01T00:00:00.000Z,2026-01-31T23:59:59.000Z
- `email` (`string`, optional): Email address on the ticket. Supports * wildcards. Example: carol@zylker.com
- `from` (`integer`, optional): Zero-based index of the first result to return, for paging. Example: 0 for the first page, 50 for the second page of 50.
- `limit` (`integer`, optional): Number of tickets to return, between 1 and 100. Defaults to 10. Example: 50
- `modified_time_range` (`string`, optional): Modified between two ISO 8601 timestamps, as from,to. Example: 2026-01-01T00:00:00.000Z,2026-01-31T23:59:59.000Z
- `priority` (`string`, optional): Exact priority, such as High, Medium or Low. Example: High
- `sort_by` (`string`, optional): Sort field: relevance, modifiedTime, createdTime or customerResponseTime. Prefix with - for descending order. Example: -modifiedTime. One of: `relevance`, `modifiedTime`, `-modifiedTime`, `createdTime`, `-createdTime`, `customerResponseTime`, `-customerResponseTime`.
- `status` (`string`, optional): Status name(s), comma-separated, including custom statuses. Example: Open,On Hold
- `subject` (`string`, optional): Text to match in the ticket subject. Supports * wildcards. Example: analysis*
- `tag` (`string`, optional): Tag on the ticket. Supports * wildcards. Example: billing
- `ticket_number` (`string`, optional): Exact ticket number shown to agents and customers (not the internal id). Example: 773

Example input: `{"org_id":"<org_id>"}`

### `zohodesk_account_create`

Create Account · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `account_name` (`string`, required): Name of the account (company), up to 200 characters. Example: Zylker Inc
- `org_id` (`string`, required): 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_revenue` (`number`, optional): Annual revenue of the account. Example: 2500000
- `cf` (`object`, optional): Custom field values as an object keyed by each field's API name (they start with cf_). Example: {"cf_activeaccount": "true"}
- `city` (`string`, optional): City. Example: Pleasanton
- `code` (`string`, optional): ZIP or postal code. Example: 94588
- `country` (`string`, optional): Country. Example: United States
- `description` (`string`, optional): Short description of the account. Example: Enterprise customer since 2019.
- `email` (`string`, optional): Email address of the account. Example: support@zylker.com
- `fax` (`string`, optional): Fax number of the account. Example: 6218129191
- `industry` (`string`, optional): Industry the account operates in. Example: Technology
- `owner_id` (`string`, optional): ID of the agent who owns the account. Get it from zohodesk_agents_list. Example: 1892000000042001
- `phone` (`string`, optional): Phone number of the account. Example: 6218129190
- `state` (`string`, optional): State or region. Example: California
- `street` (`string`, optional): Street address. Example: 4900 Hopyard Rd
- `website` (`string`, optional): Website of the account. Example: https://www.zylker.com

Example input: `{"account_name":"<account_name>","org_id":"<org_id>"}`

### `zohodesk_account_update`

Update Account · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_id` (`string`, required): ID of the account. Get it from zohodesk_accounts_search or zohodesk_accounts_list (id field). Example: 1892000000975382
- `org_id` (`string`, required): 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_name` (`string`, optional): Name of the account (company), up to 200 characters. Example: Zylker Inc
- `annual_revenue` (`number`, optional): Annual revenue of the account. Example: 2500000
- `cf` (`object`, optional): Custom field values as an object keyed by each field's API name (they start with cf_). Example: {"cf_activeaccount": "true"}
- `city` (`string`, optional): City. Example: Pleasanton
- `code` (`string`, optional): ZIP or postal code. Example: 94588
- `country` (`string`, optional): Country. Example: United States
- `description` (`string`, optional): Short description of the account. Example: Enterprise customer since 2019.
- `email` (`string`, optional): Email address of the account. Example: support@zylker.com
- `fax` (`string`, optional): Fax number of the account. Example: 6218129191
- `industry` (`string`, optional): Industry the account operates in. Example: Technology
- `owner_id` (`string`, optional): ID of the agent who owns the account. Get it from zohodesk_agents_list. Example: 1892000000042001
- `phone` (`string`, optional): Phone number of the account. Example: 6218129190
- `state` (`string`, optional): State or region. Example: California
- `street` (`string`, optional): Street address. Example: 4900 Hopyard Rd
- `website` (`string`, optional): Website of the account. Example: https://www.zylker.com

Example input: `{"account_id":"<account_id>","org_id":"<org_id>"}`

### `zohodesk_contact_create`

Create Contact · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `last_name` (`string`, required): Last name of the contact, up to 200 characters. Example: Smith
- `org_id` (`string`, required): 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_id` (`string`, optional): ID of the account (company) the contact belongs to. Get it from zohodesk_accounts_search. Example: 1892000000975382
- `cf` (`object`, optional): Custom field values as an object keyed by each field's API name (they start with cf_). Example: {"cf_permanentaddress": "Pleasanton"}
- `city` (`string`, optional): City. Example: Pleasanton
- `country` (`string`, optional): Country. Example: United States
- `description` (`string`, optional): Notes about the contact. Example: Prefers phone calls.
- `email` (`string`, optional): Primary email address. Example: carol@zylker.com
- `first_name` (`string`, optional): First name of the contact. Example: Carol
- `language` (`string`, optional): Preferred language. Example: English
- `mobile` (`string`, optional): Mobile number. Example: +1 555 010 2030
- `owner_id` (`string`, optional): ID of the agent who owns the contact. Get it from zohodesk_agents_list. Example: 1892000000042001
- `phone` (`string`, optional): Phone number. Example: 1 888 900 9646
- `secondary_email` (`string`, optional): Secondary email address. Example: carol.smith@gmail.com
- `state` (`string`, optional): State or region. Example: California
- `street` (`string`, optional): Street address. Example: 4900 Hopyard Rd
- `title` (`string`, optional): Job title. Example: Purchase Manager
- `type` (`string`, optional): Contact type label used in the help desk. Example: Paid User
- `zip` (`string`, optional): ZIP or postal code. Example: 94588

Example input: `{"last_name":"<last_name>","org_id":"<org_id>"}`

### `zohodesk_contact_update`

Update Contact · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`string`, required): ID of the contact. Get it from zohodesk_contacts_search or zohodesk_contacts_list (id field). Example: 1892000000042032
- `org_id` (`string`, required): 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_id` (`string`, optional): ID of the account (company) the contact belongs to. Get it from zohodesk_accounts_search. Example: 1892000000975382
- `cf` (`object`, optional): Custom field values as an object keyed by each field's API name (they start with cf_). Example: {"cf_permanentaddress": "Pleasanton"}
- `city` (`string`, optional): City. Example: Pleasanton
- `country` (`string`, optional): Country. Example: United States
- `description` (`string`, optional): Notes about the contact. Example: Prefers phone calls.
- `email` (`string`, optional): Primary email address. Example: carol@zylker.com
- `first_name` (`string`, optional): First name of the contact. Example: Carol
- `language` (`string`, optional): Preferred language. Example: English
- `last_name` (`string`, optional): Last name of the contact, up to 200 characters. Example: Smith
- `mobile` (`string`, optional): Mobile number. Example: +1 555 010 2030
- `owner_id` (`string`, optional): ID of the agent who owns the contact. Get it from zohodesk_agents_list. Example: 1892000000042001
- `phone` (`string`, optional): Phone number. Example: 1 888 900 9646
- `secondary_email` (`string`, optional): Secondary email address. Example: carol.smith@gmail.com
- `state` (`string`, optional): State or region. Example: California
- `street` (`string`, optional): Street address. Example: 4900 Hopyard Rd
- `title` (`string`, optional): Job title. Example: Purchase Manager
- `type` (`string`, optional): Contact type label used in the help desk. Example: Paid User
- `zip` (`string`, optional): ZIP or postal code. Example: 94588

Example input: `{"contact_id":"<contact_id>","org_id":"<org_id>"}`

### `zohodesk_ticket_comment_add`

Add Ticket Comment · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `content` (`string`, required): 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_id` (`string`, required): 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_id` (`string`, required): ID of the ticket. Get it from zohodesk_tickets_list or zohodesk_tickets_search (id field, not ticketNumber). Example: 1892000000143237
- `content_type` (`string`, optional): Format of content: html (the default) or plainText. Example: plainText. One of: `html`, `plainText`.
- `is_public` (`boolean`, optional): true to show the comment to the customer in the help center; false (the default) keeps it private to agents. Example: false

Example input: `{"content":"<content>","org_id":"<org_id>","ticket_id":"<ticket_id>"}`

### `zohodesk_ticket_create`

Create Ticket · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `department_id` (`string`, required): ID of the department the ticket belongs to. Get it from zohodesk_departments_list. Example: 1892000000006907
- `org_id` (`string`, required): 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
- `subject` (`string`, required): Subject line of the ticket, up to 255 characters. Example: Real time analysis requirement
- `assignee_id` (`string`, optional): ID of the agent to assign the ticket to. Get it from zohodesk_agents_list. Example: 1892000000056007
- `category` (`string`, optional): Category of the ticket. Example: general
- `cf` (`object`, optional): Custom field values as an object keyed by each field's API name (they start with cf_). Example: {"cf_modelname": "F3 2017"}
- `channel` (`string`, optional): Channel the ticket came in through, such as Email, Phone, Web, Chat or Forums. Example: Email
- `classification` (`string`, optional): Ticket classification, such as Problem, Request or Question, or a custom value. Example: Problem
- `contact` (`object`, optional): 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_id` (`string`, optional): ID of an existing contact who raised the ticket. Get it from zohodesk_contacts_search. Give either contact_id or contact. Example: 1892000000042032
- `description` (`string`, optional): Body of the ticket. HTML is allowed. Example: The dashboard stops refreshing after 5 minutes.
- `due_date` (`string`, optional): Due date as an ISO 8601 timestamp. Example: 2026-06-21T16:16:16.000Z
- `email` (`string`, optional): Email address for the ticket. Example: carol@zylker.com
- `language` (`string`, optional): Language of the ticket. Example: English
- `phone` (`string`, optional): Phone number for the ticket. Example: 1 888 900 9646
- `priority` (`string`, optional): Ticket priority, such as High, Medium or Low, or a custom value. Example: High
- `product_id` (`string`, optional): ID of the product the ticket is about. Example: 1892000000094004
- `resolution` (`string`, optional): Resolution notes for the ticket. Example: Cleared the browser cache.
- `status` (`string`, optional): Ticket status, such as Open, On Hold, Escalated or Closed, or a custom status. Example: Open
- `sub_category` (`string`, optional): Subcategory of the ticket. Example: Sub General
- `team_id` (`string`, optional): ID of the team to assign the ticket to. Example: 1892000000057006

Example input: `{"department_id":"<department_id>","org_id":"<org_id>","subject":"<subject>"}`

### `zohodesk_ticket_reply_send`

Send Ticket Reply · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `channel` (`string`, required): Channel to reply through. Use EMAIL for email tickets; FACEBOOK, TWITTER and FORUMS reply on those channels. Example: EMAIL. One of: `EMAIL`, `FACEBOOK`, `TWITTER`, `FORUMS`.
- `content` (`string`, required): 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_id` (`string`, required): 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_id` (`string`, required): ID of the ticket. Get it from zohodesk_tickets_list or zohodesk_tickets_search (id field, not ticketNumber). Example: 1892000000143237
- `bcc` (`string`, optional): Email address(es) to blind-copy, comma-separated. EMAIL replies only. Example: audit@zylker.com
- `cc` (`string`, optional): Email address(es) to copy, comma-separated. EMAIL replies only. Example: lead@zylker.com
- `content_type` (`string`, optional): Format of content for EMAIL replies: plainText (the default) or html. Example: html. One of: `plainText`, `html`.
- `from_email_address` (`string`, optional): 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_id` (`string`, optional): ID of the thread this reply answers, from zohodesk_ticket_threads_list. EMAIL replies only. Example: 1892000001080004
- `ticket_status` (`string`, optional): Status to set on the ticket after replying, such as Closed or On Hold, or a custom status. Example: Closed
- `to` (`string`, optional): Recipient email address(es) for EMAIL replies, comma-separated. Example: carol@zylker.com

Example input: `{"channel":"EMAIL","content":"<content>","org_id":"<org_id>","ticket_id":"<ticket_id>"}`

### `zohodesk_ticket_update`

Update Ticket · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_id` (`string`, required): 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_id` (`string`, required): ID of the ticket. Get it from zohodesk_tickets_list or zohodesk_tickets_search (id field, not ticketNumber). Example: 1892000000143237
- `assignee_id` (`string`, optional): ID of the agent to assign the ticket to. Get it from zohodesk_agents_list. Example: 1892000000056007
- `category` (`string`, optional): Category of the ticket. Example: general
- `cf` (`object`, optional): Custom field values as an object keyed by each field's API name (they start with cf_). Example: {"cf_modelname": "F3 2017"}
- `channel` (`string`, optional): Channel the ticket came in through, such as Email, Phone, Web, Chat or Forums. Example: Email
- `classification` (`string`, optional): Ticket classification, such as Problem, Request or Question, or a custom value. Example: Problem
- `contact_id` (`string`, optional): ID of the contact to link the ticket to. Get it from zohodesk_contacts_search. Example: 1892000000042032
- `department_id` (`string`, optional): ID of the department the ticket belongs to. Get it from zohodesk_departments_list. Example: 1892000000006907
- `description` (`string`, optional): Body of the ticket. HTML is allowed. Example: The dashboard stops refreshing after 5 minutes.
- `due_date` (`string`, optional): Due date as an ISO 8601 timestamp. Example: 2026-06-21T16:16:16.000Z
- `email` (`string`, optional): Email address for the ticket. Example: carol@zylker.com
- `language` (`string`, optional): Language of the ticket. Example: English
- `phone` (`string`, optional): Phone number for the ticket. Example: 1 888 900 9646
- `priority` (`string`, optional): Ticket priority, such as High, Medium or Low, or a custom value. Example: High
- `product_id` (`string`, optional): ID of the product the ticket is about. Example: 1892000000094004
- `resolution` (`string`, optional): Resolution notes for the ticket. Example: Cleared the browser cache.
- `status` (`string`, optional): Ticket status, such as Open, On Hold, Escalated or Closed, or a custom status. Example: Open
- `sub_category` (`string`, optional): Subcategory of the ticket. Example: Sub General
- `subject` (`string`, optional): Subject line of the ticket, up to 255 characters. Example: Real time analysis requirement
- `team_id` (`string`, optional): ID of the team to assign the ticket to. Example: 1892000000057006

Example input: `{"org_id":"<org_id>","ticket_id":"<ticket_id>"}`

## Related

Other Customer Support connectors ([all 38](/agentkit/connectors/?category=customer-support)):

- [ServiceNow](/agentkit/connectors/servicenow/): Scalekit connector, OAuth, 112 tools
- [Zendesk](/agentkit/connectors/zendeskoauth/): Scalekit connector, OAuth, 137 tools
- [Jira Service Management](/agentkit/connectors/jiraservicemanagement/): Scalekit connector, OAuth, 72 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
