# 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                                                                                                                                                       |
| -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [Add Comment / Reply](/reference/blocks/zendesk-add-comment)                           | Add a public reply or internal note to a ticket                                                                                                                    |
| [Add Tags](/reference/blocks/zendesk-add-tags)                                         | Add tags to a ticket for classification and tracking                                                                                                               |
| [Apply Macro](/reference/blocks/zendesk-apply-macro)                                   | Apply a predefined macro to a ticket                                                                                                                               |
| [Assign Ticket](/reference/blocks/zendesk-assign-ticket)                               | Assign a ticket to an agent or group                                                                                                                               |
| [Close Ticket](/reference/blocks/zendesk-close-ticket)                                 | Mark a ticket as solved with optional closing message                                                                                                              |
| [Create Custom Object Record](/reference/blocks/zendesk-create-custom-object-record)   | Create a new custom object record                                                                                                                                  |
| [Create Ticket](/reference/blocks/zendesk-create-ticket)                               | Create a new Zendesk ticket                                                                                                                                        |
| [Create User](/reference/blocks/zendesk-create-user)                                   | Create a new Zendesk user                                                                                                                                          |
| [Delete Custom Object Record](/reference/blocks/zendesk-delete-custom-object-record)   | Delete a custom object record by ID                                                                                                                                |
| [Get Conversation](/reference/blocks/zendesk-get-conversation)                         | Fetch a Sunshine Conversations conversation, including current switchboard control.                                                                                |
| [Get Custom Object Record](/reference/blocks/zendesk-get-custom-object-record)         | Fetch a Zendesk custom object record by ID                                                                                                                         |
| [Get Organization](/reference/blocks/zendesk-get-organization)                         | Get organization details for B2B context                                                                                                                           |
| [Get Ticket](/reference/blocks/zendesk-get-ticket)                                     | Fetch a Zendesk ticket by ID and return its full data object for downstream use.                                                                                   |
| [Get Ticket Comments](/reference/blocks/zendesk-get-ticket-comments)                   | Get conversation history for a ticket                                                                                                                              |
| [Get Ticket Context](/reference/blocks/zendesk-get-ticket-context)                     | Get complete ticket context (ticket, conversation, customer, assignee, organization) optimized for AI                                                              |
| [Get User](/reference/blocks/zendesk-get-user)                                         | Fetch a Zendesk user by ID                                                                                                                                         |
| [Get User Tickets](/reference/blocks/zendesk-get-user-tickets)                         | Get ticket history for a customer                                                                                                                                  |
| [List Agents](/reference/blocks/zendesk-list-agents)                                   | Get available agents for ticket assignment                                                                                                                         |
| [List Custom Objects](/reference/blocks/zendesk-list-custom-objects)                   | List all custom object definitions in the Zendesk account                                                                                                          |
| [List Groups](/reference/blocks/zendesk-list-groups)                                   | Get all available groups for routing tickets                                                                                                                       |
| [List Macros](/reference/blocks/zendesk-list-macros)                                   | Get available macros for ticket automation                                                                                                                         |
| [Pass Conversation Control](/reference/blocks/zendesk-pass-conversation-control)       | Pass switchboard control to another integration (e.g. escalate to a human agent).                                                                                  |
| [Post Conversation Message](/reference/blocks/zendesk-post-conversation-message)       | Send a business-authored message on a Sunshine Conversations conversation (messaging channels).                                                                    |
| [Release Conversation Control](/reference/blocks/zendesk-release-conversation-control) | Release switchboard control back to the default integration (per marketplace bot SHOULD).                                                                          |
| [Remove Tags](/reference/blocks/zendesk-remove-tags)                                   | Remove tags from a ticket                                                                                                                                          |
| [Search Custom Object Records](/reference/blocks/zendesk-search-custom-object-records) | Search custom object records by query string                                                                                                                       |
| [Search Tickets](/reference/blocks/zendesk-search-tickets)                             | Search for Zendesk tickets                                                                                                                                         |
| [Set Lookup Field](/reference/blocks/zendesk-set-lookup-field)                         | Set a lookup relationship field on a ticket to a custom object record by ID, name, or external ID                                                                  |
| [Set Ticket Priority](/reference/blocks/zendesk-set-ticket-priority)                   | Set the priority level on a Zendesk ticket (low, normal, high, or urgent).                                                                                         |
| [Set Ticket Type](/reference/blocks/zendesk-set-ticket-type)                           | Set ticket type (problem, incident, question, task)                                                                                                                |
| [Update Custom Object Record](/reference/blocks/zendesk-update-custom-object-record)   | Update an existing custom object record                                                                                                                            |
| [Update Ticket](/reference/blocks/zendesk-update-ticket)                               | Update ticket with comment, status, tags, priority in one API call. Comment text supports markdown — see the Comment field description for the rendering contract. |
| [Upsert Custom Object Record](/reference/blocks/zendesk-upsert-custom-object-record)   | Create or update a custom object record by external ID or name                                                                                                     |

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)