---
title: "How do I connect Zendesk?"
description: "TL;DR: Connect Zendesk to Ballet with an inbound webhook (to start playbooks from ticket events) and optional API/MCP credentials (to read or update tickets during a run)."
canonical_url: "https://docs.ballet.dev/articles/how-do-i-connect-zendesk-4vye05wEeF"
md_url: "https://docs.ballet.dev/articles/how-do-i-connect-zendesk-4vye05wEeF.md"
---
# How do I connect Zendesk?

TL;DR: Connect Zendesk to Ballet with an inbound webhook (to start playbooks from ticket events) and optional API/MCP credentials (to read or update tickets during a run).

Back to: [How do I connect CRM and support tools?](/articles/how-do-i-connect-crm-and-support-tools-5h3LJzY5x8)

> **Status:** Draft outline for customer handoff. Expand steps with screenshots as needed.

## Patterns

## Outline: inbound webhook

1. In Ballet, add a **Webhook** trigger and choose the **Zendesk** provider. Copy the trigger URL.
2. Store your Zendesk API token in Ballet [Secrets](/articles/how-do-i-store-credentials-with-secrets-1D8OUcCo0n) (used to register/verify webhooks).
3. In Zendesk Admin Center → Apps and integrations → Webhooks, create a webhook and paste the Ballet URL.
4. Choose the events that should trigger the playbook (for example, ticket created).

See: [How do I trigger and react to playbooks with webhooks?](/articles/how-do-i-trigger-and-react-to-playbooks-with-webhooks-DYv9XyeU51)

Zendesk docs: [Webhooks API](https://developer.zendesk.com/api-reference/webhooks/webhooks-api/webhooks/)

## Outline: API / MCP (optional)

1. Create a Zendesk API token for an integration admin user.
2. Connect Zendesk from Ballet Connectors (MCP registry) or store the token in Secrets for HTTP steps.
3. Confirm the token can read/write the ticket fields your playbook needs.

See: [How do I connect an MCP server?](/articles/how-do-i-connect-an-mcp-server-RtBQhNBIoy)