> This page is for Workforce.

> 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