# Zendesk
URL: /reference/integrations/zendesk
Type: reference
Description: Manage tickets, users, and support workflows.
Keywords: zendesk, integration, oauth, connect
Manage tickets, users, and support workflows.

Connect [#connect]

Connect Zendesk in **Settings → Integrations**. Open the Zendesk card, click **Connect**, and authorize Stylo to access your Zendesk account in the window that opens. The connection shows as **Connected** when authorization succeeds.

{/* TODO(docs): document the exact Zendesk scopes/permissions Stylo requests — not encoded in the provider definition. */}

Supported actions and triggers [#supported-actions-and-triggers]

Actions [#actions]

| Block                                | What it does                                                                               |
| ------------------------------------ | ------------------------------------------------------------------------------------------ |
| [Zendesk](/reference/blocks/zendesk) | Work with Zendesk tickets, users, organizations, macros, custom objects, and conversations |

Messaging (Sunshine Conversations) [#messaging-sunshine-conversations]

Stylo can **observe** Zendesk messaging conversations (WhatsApp, Web Widget, and other Sunshine Conversations channels) and surface suggested replies in Assist. Stylo joins as a read-only observer — it **never takes control** of the conversation, so your agents (or your existing bot) stay in charge.

Connect messaging [#connect-messaging]

1. In Zendesk, open **Admin Center → Apps and integrations → APIs → Conversations API**.
2. Click **Add API key** and copy the **App ID**, **Key ID**, and **Secret**.
3. In Stylo, go to **Settings → Integrations → Zendesk → Messaging Channels**, click **Connect Messaging**, and paste the three values.

Stylo verifies the key and creates a dedicated observer integration on your Sunshine Conversations app. To stop observing, click **Disconnect Messaging** — this removes the observer integration and leaves ticket-based assist untouched.

Limits and failure modes [#limits-and-failure-modes]

* The connection can expire or be revoked. When it does, Zendesk blocks fail with an authorization error until you reconnect in **Settings → Integrations**.
* A disconnected or unconfigured integration makes its blocks unavailable in the Workflow Builder.

{/* TODO(docs): document Zendesk-specific rate limits and permission errors — not encoded in @stylo/core. */}

Related [#related]

* [Integrations overview](/integrations)
* [All workflow blocks](/reference/blocks)
* [Troubleshooting](/troubleshooting)