# Zendesk — Pipedream Connect

> Zendesk is award-winning customer service software trusted by 200K+ customers. Make customers happy via text, mobile, phone, email, live chat, social media.

- API slug: `zendesk` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: Help Desk & Support
- Website: https://zendesk.com
- Managed OAuth scopes: `triggers:write` · `webhooks:write` · `read` · `tickets:write` · `tickets:read` · `users:write` · `organizations:read` · `organizations:write`
- This page (HTML): https://pipedream.com/apps/zendesk
- Tools: 33 actions · 10 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: zendesk`

```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": "zendesk",
      },
    },
  },
)

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 Tags:
const result = await mcp.callTool({
  name: "zendesk-add-ticket-tags",
  arguments: {
    ticketId: "Ticket ID",
    ticketTags: ["Tags"],
  },
})
```

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

## API proxy

For a Zendesk 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: "zendesk-add-ticket-tags",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    zendesk: { authProvisionId: "apn_xxxxxxx" },
    ticketId: "Ticket ID",
    ticketTags: ["Tags"],
  },
})
```

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

## Actions (33)

### `zendesk-add-ticket-tags` — Add Ticket Tags (Write)

Add tags to a ticket (appends to existing tags). See the documentation.

Full schema: https://pipedream.com/apps/zendesk/actions/add-ticket-tags.md

### `zendesk-create-side-conversation` — Create Side Conversation (Write)

Create a side conversation on a Zendesk ticket using email, Zendesk agent, Slack, Microsoft Teams, or child-ticket participants. Requires the Zendesk Collaboration add-on. Use List Side Conversations to inspect existing conversations. See the documentation

Full schema: https://pipedream.com/apps/zendesk/actions/create-side-conversation.md

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

Creates a ticket. See the documentation.

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

### `zendesk-delete-ticket` — Delete Ticket (Write)

Deletes a ticket. See the documentation.

Full schema: https://pipedream.com/apps/zendesk/actions/delete-ticket.md

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

Retrieves an article by its ID. See the documentation.

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

### `zendesk-get-dynamic-content-item` — Get Dynamic Content Item (Read-only)

Retrieves a dynamic content item. Note: Dynamic content is available only on the Professional plan and above. See the documentation.

Full schema: https://pipedream.com/apps/zendesk/actions/get-dynamic-content-item.md

### `zendesk-get-dynamic-content-items-by-name` — Get Dynamic Content Items by Name (Read-only)

Retrieves multiple dynamic content items by their names. Note: Dynamic content is available only on the Professional plan and above. See the documentation.

Full schema: https://pipedream.com/apps/zendesk/actions/get-dynamic-content-items-by-name.md

### `zendesk-get-macro` — Get Macro (Read-only)

Retrieves a macro by its ID. See the documentation.

Full schema: https://pipedream.com/apps/zendesk/actions/get-macro.md

### `zendesk-get-side-conversation` — Get Side Conversation (Read-only)

Retrieve a single Zendesk side conversation by ID (UUID, e.g. 8566255a-ece5-11e8-857d-493066fa7b17). Use List Side Conversations to discover IDs for a given ticket. Set includeEvents to true to sideload the conversation's events (creation, replies, state changes). See the documentation.

Full schema: https://pipedream.com/apps/zendesk/actions/get-side-conversation.md

### `zendesk-get-ticket-info` — Get Ticket Info (Read-only)

Retrieves information about a specific ticket. See the documentation.

Full schema: https://pipedream.com/apps/zendesk/actions/get-ticket-info.md

### `zendesk-get-user-info` — Get User Info (Read-only)

Retrieves information about a specific user. See the documentation.

Full schema: https://pipedream.com/apps/zendesk/actions/get-user-info.md

### `zendesk-list-active-macros` — List Active Macros (Read-only)

Lists all active shared and personal macros available to the current user. See the documentation.

Full schema: https://pipedream.com/apps/zendesk/actions/list-active-macros.md

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

Retrieves a list of articles. See the documentation.

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

### `zendesk-list-dynamic-content-items` — List Dynamic Content Items (Read-only)

Retrieves a list of dynamic content items. Note: Dynamic content is available only on the Professional plan and above. See the documentation.

Full schema: https://pipedream.com/apps/zendesk/actions/list-dynamic-content-items.md

### `zendesk-list-fields-options` — List Fields Options (Read-only)

Retrieves available options for the Fields field.

Full schema: https://pipedream.com/apps/zendesk/actions/list-fields-options.md

### `zendesk-list-locales` — List Locales (Read-only)

Retrieves all locales. See the documentation.

Full schema: https://pipedream.com/apps/zendesk/actions/list-locales.md

### `zendesk-list-macro-category-options` — List Macro Category Options (Read-only)

Retrieves available options for the Macro Category field.

Full schema: https://pipedream.com/apps/zendesk/actions/list-macro-category-options.md

### `zendesk-list-macros` — List Macros (Read-only)

Retrieves all macros. See the documentation.

Full schema: https://pipedream.com/apps/zendesk/actions/list-macros.md

### `zendesk-list-side-conversations` — List Side Conversations (Read-only)

Retrieve all side conversations on a Zendesk ticket. Side conversations are collaboration threads attached to a ticket (email, Slack, Microsoft Teams, or linked child tickets). Use Get Side Conversation to fetch a single side conversation by ID. Set includeEvents to true to sideload each…

Full schema: https://pipedream.com/apps/zendesk/actions/list-side-conversations.md

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

Retrieves all comments for a specific ticket. See the documentation.

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

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

Retrieves a list of tickets. See the documentation.

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

### `zendesk-remove-ticket-tags` — Remove Ticket Tags (Write)

Remove specific tags from a ticket. See the documentation.

Full schema: https://pipedream.com/apps/zendesk/actions/remove-ticket-tags.md

### `zendesk-reply-to-side-conversation` — Reply to Side Conversation (Write)

Reply to an existing Zendesk side conversation. Zendesk requires recipients on every reply, so pass the participants the reply should go to. See the documentation

Full schema: https://pipedream.com/apps/zendesk/actions/reply-to-side-conversation.md

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

Searches Help Center articles. See the documentation.

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

### `zendesk-search-community-posts` — Search Community Posts (Read-only)

Searches Help Center community posts. See the documentation.

Full schema: https://pipedream.com/apps/zendesk/actions/search-community-posts.md

### `zendesk-search-help-center` — Search Help Center (Read-only)

Searches across knowledge base articles, community posts, and external records using the Zendesk unified Guide search. See the documentation.

Full schema: https://pipedream.com/apps/zendesk/actions/search-help-center.md

### `zendesk-search-macros` — Search Macros (Read-only)

Search for macros by name. See the documentation.

Full schema: https://pipedream.com/apps/zendesk/actions/search-macros.md

### `zendesk-search-tickets` — Search Tickets (Read-only)

Searches for tickets using Zendesk's search API. See the documentation.

Full schema: https://pipedream.com/apps/zendesk/actions/search-tickets.md

### `zendesk-set-custom-ticket-fields` — Set Custom Ticket Fields (Write)

Sets one or more custom field values on a ticket. See the documentation.

Full schema: https://pipedream.com/apps/zendesk/actions/set-custom-ticket-fields.md

### `zendesk-set-ticket-tags` — Set Ticket Tags (Write)

Set tags on a ticket (replaces all existing tags). See the documentation.

Full schema: https://pipedream.com/apps/zendesk/actions/set-ticket-tags.md

### `zendesk-update-side-conversation` — Update Side Conversation (Write)

Update the state or subject of a Zendesk side conversation. See the documentation

Full schema: https://pipedream.com/apps/zendesk/actions/update-side-conversation.md

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

Updates a ticket. See the documentation.

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

### `zendesk-upload-ticket-attachments` — Upload Ticket Attachments (Write)

Upload one or more files as ticket attachments via the Zendesk Uploads API. Returns upload tokens that can be used when creating or updating tickets. See the documentation.

Full schema: https://pipedream.com/apps/zendesk/actions/upload-ticket-attachments.md

## Triggers (10)

### `zendesk-locale-updated` — Locale Updated (Polling)

Emit new event when a locale has been updated

Full schema: https://pipedream.com/apps/zendesk/triggers/locale-updated.md

### `zendesk-new-side-conversation` — New Side Conversation (Polling)

Emit new event when a side conversation is created on a ticket. See the documentation

Full schema: https://pipedream.com/apps/zendesk/triggers/new-side-conversation.md

### `zendesk-new-side-conversation-reply` — New Side Conversation Reply (Polling)

Emit new event when a reply is added to an existing side conversation on a ticket. See the documentation

Full schema: https://pipedream.com/apps/zendesk/triggers/new-side-conversation-reply.md

### `zendesk-new-ticket` — New Ticket (Instant) (Instant)

Emit new event when a ticket is created

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

### `zendesk-ticket-added-to-view` — New Ticket Added to View (Instant) (Instant)

Emit new event when a ticket is added to the specified view

Full schema: https://pipedream.com/apps/zendesk/triggers/ticket-added-to-view.md

### `zendesk-new-ticket-comment-added` — New Ticket Comment Added (Instant) (Instant)

Emit new event when a ticket comment has been added

Full schema: https://pipedream.com/apps/zendesk/triggers/new-ticket-comment-added.md

### `zendesk-ticket-closed` — Ticket Closed (Instant) (Instant)

Emit new event when a ticket has changed to closed status

Full schema: https://pipedream.com/apps/zendesk/triggers/ticket-closed.md

### `zendesk-ticket-pended` — Ticket Pending (Instant) (Instant)

Emit new event when a ticket has changed to pending status

Full schema: https://pipedream.com/apps/zendesk/triggers/ticket-pended.md

### `zendesk-ticket-solved` — Ticket Solved (Instant) (Instant)

Emit new event when a ticket has changed to solved status

Full schema: https://pipedream.com/apps/zendesk/triggers/ticket-solved.md

### `zendesk-ticket-updated` — Ticket Updated (Instant) (Instant)

Emit new event when a ticket has been updated

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

---

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