# Zoho Desk — Pipedream Connect

> Omnichannel customer service software to delight and retain customers.

- API slug: `zoho_desk` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: Business Management
- Website: https://www.zoho.com/desk/
- Managed OAuth scopes: `Desk.articles.CREATE` · `Desk.articles.READ` · `Desk.articles.UPDATE` · `Desk.basic.CREATE` · `Desk.basic.READ` · `Desk.contacts.CREATE` · `Desk.contacts.READ` · `Desk.contacts.UPDATE` · `Desk.contacts.WRITE` · `Desk.events.CREATE` · `Desk.events.READ` · `Desk.events.UPDATE` · `Desk.events.WRITE` · `Desk.search.READ` · `Desk.settings.CREATE` · `Desk.settings.READ` · `Desk.settings.UPDATE` · `Desk.settings.WRITE` · `Desk.tasks.CREATE` · `Desk.tasks.READ` · `Desk.tasks.UPDATE` · `Desk.tasks.WRITE` · `Desk.tickets.CREATE` · `Desk.tickets.READ` · `Desk.tickets.UPDATE` · `Desk.tickets.WRITE`
- This page (HTML): https://pipedream.com/apps/zoho-desk
- Tools: 30 actions · 12 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: zoho_desk`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "zoho_desk",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Add Ticket Attachment:
const result = await mcp.callTool({
  name: "zoho_desk-add-ticket-attachment",
  arguments: {
    orgId: "Organization ID",
    ticketId: "Ticket ID",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Zoho Desk endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.example.com/v1/me

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkuZXhhbXBsZS5jb20vdjEvbWU?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "zoho_desk-add-ticket-attachment",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    zoho_desk: { authProvisionId: "apn_xxxxxxx" },
    orgId: "Organization ID",
    ticketId: "Ticket ID",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (30)

### `zoho_desk-add-ticket-attachment` — Add Ticket Attachment (Write)

Attaches a file to a ticket. See the docs here

Full schema: https://pipedream.com/apps/zoho-desk/actions/add-ticket-attachment.md

### `zoho_desk-add-ticket-comment` — Add Ticket Comment (Write)

Adds a comment to a ticket. See the docs here

Full schema: https://pipedream.com/apps/zoho-desk/actions/add-ticket-comment.md

### `zoho_desk-create-account` — Create Account (Write)

Creates an account in your help desk portal. See the docs here

Full schema: https://pipedream.com/apps/zoho-desk/actions/create-account.md

### `zoho_desk-create-contact` — Create Contact (Write)

Creates a contact in your help desk portal. See the docs here

Full schema: https://pipedream.com/apps/zoho-desk/actions/create-contact.md

### `zoho_desk-create-ticket` — Create Ticket (Write)

Creates a ticket in your helpdesk. See the docs here

Full schema: https://pipedream.com/apps/zoho-desk/actions/create-ticket.md

### `zoho_desk-delete-ticket-comment` — Delete Ticket Comment (Write)

Deletes a specific comment from a ticket. See the documentation

Full schema: https://pipedream.com/apps/zoho-desk/actions/delete-ticket-comment.md

### `zoho_desk-download-thread-attachment` — Download Thread Attachment (Read-only)

Download a specific attachment belonging to a thread of a ticket. See the documentation

Full schema: https://pipedream.com/apps/zoho-desk/actions/download-thread-attachment.md

### `zoho_desk-find-contact` — Find Contact (Read-only)

Searches for contacts in your help desk portal. See the docs here

Full schema: https://pipedream.com/apps/zoho-desk/actions/find-contact.md

### `zoho_desk-find-or-create-contact` — Find or Create Contact (Read-only)

Finds or create a contact. See the docs here

Full schema: https://pipedream.com/apps/zoho-desk/actions/find-or-create-contact.md

### `zoho_desk-get-article` — Get Article (Read-only)

Retrieves the details of a knowledge base article. See the documentation

Full schema: https://pipedream.com/apps/zoho-desk/actions/get-article.md

### `zoho_desk-get-thread-details` — Get Thread Details (Read-only)

Retrieve details for a specific thread belonging to a ticket. See the documentation

Full schema: https://pipedream.com/apps/zoho-desk/actions/get-thread-details.md

### `zoho_desk-get-ticket-comment` — Get Ticket Comment (Read-only)

Retrieves details of a specific comment on a ticket. See the documentation

Full schema: https://pipedream.com/apps/zoho-desk/actions/get-ticket-comment.md

### `zoho_desk-get-ticket-comment-history` — Get Ticket Comment History (Read-only)

Retrieves the edit history of a specific ticket comment. See the documentation

Full schema: https://pipedream.com/apps/zoho-desk/actions/get-ticket-comment-history.md

### `zoho_desk-get-ticket-details` — Get Ticket Details (Read-only)

Retrieve details for a specified ticket. See the documentation

Full schema: https://pipedream.com/apps/zoho-desk/actions/get-ticket-details.md

### `zoho_desk-list-ticket-comments` — List All Ticket Comments (Read-only)

Retrieves all comments for a specified ticket. See the documentation

Full schema: https://pipedream.com/apps/zoho-desk/actions/list-ticket-comments.md

### `zoho_desk-list-articles` — List Articles (Read-only)

Lists knowledge base articles for a help center. See the documentation

Full schema: https://pipedream.com/apps/zoho-desk/actions/list-articles.md

### `zoho_desk-list-conversations` — List Conversations (Read-only)

List all conversations for a ticket. See the documentation

Full schema: https://pipedream.com/apps/zoho-desk/actions/list-conversations.md

### `zoho_desk-list-departments` — List Departments (Read-only)

Lists the departments configured in the organization, with optional filtering by enabled/disabled state. Use this to drive workflows by department name lookups instead of hardcoded department IDs. See the documentation

Full schema: https://pipedream.com/apps/zoho-desk/actions/list-departments.md

### `zoho_desk-list-help-centers` — List Help Centers (Read-only)

Lists the help centers configured in an organization. See the documentation

Full schema: https://pipedream.com/apps/zoho-desk/actions/list-help-centers.md

### `zoho_desk-list-root-categories` — List Root Categories (Read-only)

Lists root knowledge base categories for a help center. See the documentation

Full schema: https://pipedream.com/apps/zoho-desk/actions/list-root-categories.md

### `zoho_desk-list-ticket-attachments` — List Ticket Attachments (Read-only)

List attachments for a specific ticket. See the documentation

Full schema: https://pipedream.com/apps/zoho-desk/actions/list-ticket-attachments.md

### `zoho_desk-list-ticket-fields` — List Ticket Fields (Read-only)

Lists every field configured on a Zoho Desk module (defaults to Tickets), including each field's apiName, displayLabel, type, and for picklist fields - the allowedValues array. Useful for discovering valid picklist values (e.g. for status, priority, channel, category, subCategory, classification)…

Full schema: https://pipedream.com/apps/zoho-desk/actions/list-ticket-fields.md

### `zoho_desk-list-ticket-threads` — List Ticket Threads (Read-only)

Get a list of threads for a specified ticket. See the documentation

Full schema: https://pipedream.com/apps/zoho-desk/actions/list-ticket-threads.md

### `zoho_desk-list-tickets` — List Tickets (Read-only)

Lists all tickets in your help desk with optional filtering. See the docs here

Full schema: https://pipedream.com/apps/zoho-desk/actions/list-tickets.md

### `zoho_desk-search-articles` — Search Articles (Read-only)

Searches for knowledge base articles. See the documentation

Full schema: https://pipedream.com/apps/zoho-desk/actions/search-articles.md

### `zoho_desk-search-ticket` — Search Ticket (Read-only)

Searches for tickets in your help desk. See the docs here

Full schema: https://pipedream.com/apps/zoho-desk/actions/search-ticket.md

### `zoho_desk-send-email-reply` — Send E-Mail Reply (Write)

Sends an email reply. See the docs here

Full schema: https://pipedream.com/apps/zoho-desk/actions/send-email-reply.md

### `zoho_desk-update-contact` — Update Contact (Write)

Updates details of an existing contact. See the docs here

Full schema: https://pipedream.com/apps/zoho-desk/actions/update-contact.md

### `zoho_desk-update-ticket` — Update Ticket (Write)

Updates an existing ticket. See the docs here

Full schema: https://pipedream.com/apps/zoho-desk/actions/update-ticket.md

### `zoho_desk-update-ticket-comment` — Update Ticket Comment (Write)

Updates an existing comment on a ticket. See the documentation

Full schema: https://pipedream.com/apps/zoho-desk/actions/update-ticket-comment.md

## Triggers (12)

### `zoho_desk-deleted-article-instant` — Deleted Article (Instant) (Instant)

Emit new event when an article is deleted from the recycle bin

Full schema: https://pipedream.com/apps/zoho-desk/triggers/deleted-article-instant.md

### `zoho_desk-new-account` — New Account (Polling)

Emit new event when a new account is created. See the docs here

Full schema: https://pipedream.com/apps/zoho-desk/triggers/new-account.md

### `zoho_desk-new-agent` — New Agent (Polling)

Emit new event when a new agent is created. See the docs here

Full schema: https://pipedream.com/apps/zoho-desk/triggers/new-agent.md

### `zoho_desk-new-article-instant` — New Article (Instant) (Instant)

Emit new event when a new article is created

Full schema: https://pipedream.com/apps/zoho-desk/triggers/new-article-instant.md

### `zoho_desk-new-contact` — New Contact (Polling)

Emit new event when a new contact is created. See the docs here

Full schema: https://pipedream.com/apps/zoho-desk/triggers/new-contact.md

### `zoho_desk-new-ticket` — New Ticket (Polling)

Emit new event when a new ticket is created. See the docs here

Full schema: https://pipedream.com/apps/zoho-desk/triggers/new-ticket.md

### `zoho_desk-new-ticket-attachment` — New Ticket Attachment (Polling)

Emit new event when a new ticket attachment is created. See the docs here

Full schema: https://pipedream.com/apps/zoho-desk/triggers/new-ticket-attachment.md

### `zoho_desk-new-ticket-comment` — New Ticket Comment (Polling)

Emit new event when a new ticket comment is created. See the docs here

Full schema: https://pipedream.com/apps/zoho-desk/triggers/new-ticket-comment.md

### `zoho_desk-new-ticket-message` — New Ticket Message (Polling)

Emit new event when a message ticket is created. See the docs here

Full schema: https://pipedream.com/apps/zoho-desk/triggers/new-ticket-message.md

### `zoho_desk-changed-ticket-status` — New Ticket Status Change (Polling)

Emit new event when a status ticket is changed. See the docs here

Full schema: https://pipedream.com/apps/zoho-desk/triggers/changed-ticket-status.md

### `zoho_desk-updated-ticket` — New Updated Ticket (Polling)

Emit new event when a ticket is updated. See the docs here

Full schema: https://pipedream.com/apps/zoho-desk/triggers/updated-ticket.md

### `zoho_desk-updated-article-instant` — Updated Article (Instant) (Instant)

Emit new event when an article is updated

Full schema: https://pipedream.com/apps/zoho-desk/triggers/updated-article-instant.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt