> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Zoho Desk

**Authentication:** OAuth or API token. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* Show me every ticket open more than 48 hours without a reply.
* Reassign all `priority:urgent` tickets from John to Maria.
* Pull the median first-response time for the support team last week.

## Available Tools

#### list\_accounts

List customer accounts with sorting and pagination.

#### get\_account

Get detailed information for a specific customer account by ID.

#### create\_account

Create a new customer account with company name and business details.

#### update\_account

Update an existing customer account's company information.

#### delete\_account

Permanently delete a customer account from the system.

#### list\_agents

List support agents with roles, status, and pagination.

#### get\_agent

Get detailed profile information for a specific agent by ID.

#### list\_contacts

List contacts with email filtering, search, sorting, and pagination.

#### get\_contact

Get detailed information for a specific contact by ID.

#### create\_contact

Create a new customer contact with email and profile details.

#### update\_contact

Update an existing contact's profile information and details.

#### delete\_contact

Permanently delete a contact from the system.

#### list\_teams

List support teams (Note: ZohoDesk teams API does not support pagination parameters).

#### get\_team

Get detailed information for a specific team by ID.

#### list\_roles

List agent roles with pagination.

#### list\_views

List ticket views with pagination.

#### list\_tags

List tags for ticket categorization with pagination.

#### list\_time\_entries

List time entries logged by agents with pagination.

#### create\_time\_entry

Create a new time entry for tracking work hours.

#### list\_articles

List knowledge base articles with pagination and filtering.

#### get\_article

Get detailed information for a specific knowledge base article.

#### create\_article

Create a new knowledge base article with title and content.

#### update\_article

Update an existing knowledge base article's content or metadata.

#### delete\_article

Move a knowledge base article to trash (soft delete).

#### list\_layouts

List layout configurations with pagination.

#### list\_departments

List support departments with pagination.

#### get\_department

Get detailed information for a specific department by ID.

#### list\_products

List products for ticket categorization with pagination.

#### get\_product

Get detailed information for a specific product by ID.

#### create\_product

Create a new product with name and optional details.

#### list\_tasks

List tasks with status filtering and pagination.

#### get\_task

Get detailed information for a specific task by ID.

#### create\_task

Create a new task with subject and status.

#### update\_task

Update an existing task's status, priority, or other fields.

#### search

Perform global search across tickets, contacts, and accounts.

#### get\_organization

Get organization configuration details and settings.

#### list\_ticket\_threads

List comments and conversation threads for a specific ticket.

#### create\_ticket\_comment

Add a new comment or reply to a ticket with visibility control.

#### upload\_ticket\_attachment

Upload a file attachment to a specific ticket.

#### download\_ticket\_attachment

Download a file attachment from a ticket by attachment ID.

#### list\_tickets

List tickets with filtering, sorting, and pagination support.

#### get\_ticket

Get detailed information for a specific ticket by ID.

#### create\_ticket

Create a new support ticket with subject, contact, and optional details.

#### update\_ticket

Update an existing ticket's status, priority, assignment, or other fields.

#### close\_ticket

Close a ticket by marking the status