> ## Documentation Index
> Fetch the complete documentation index at: https://docs.botcadence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Zendesk

> Connect Zendesk for workflow ticket creation and status lookup

Zendesk connects your Zendesk account so the workflow **Create ticket** and **Get ticket status** tools can open and look up tickets in Zendesk. You enter the subdomain, then sign in with Zendesk.

## Prerequisites

* A Zendesk account
* The subdomain from your Zendesk URL
* Permission to authorize Botcadence in that account
* Permission to add integrations on the project

## Connect

<Steps>
  <Step title="Open Add Integration">
    In the project sidebar, select **Integrations**, then **Add Integration**. Select **Connect** on the **Zendesk** card.
  </Step>

  <Step title="Enter your subdomain">
    On **Zendesk subdomain**, enter the subdomain only, such as `yourcompany` for `yourcompany.zendesk.com`.
  </Step>

  <Step title="Sign in with Zendesk">
    On **Sign in with Zendesk**, authorize Botcadence to create and look up Zendesk tickets.
  </Step>

  <Step title="Wait for the success screen">
    When the wizard finishes, you see **Zendesk connected**.
  </Step>
</Steps>

## Verify

On **Integrations**, the row shows **Connected**.

<Check>
  Enable [Create ticket](/docs/build/workflows/tools/create-ticket) on a test agent, select this Zendesk connection, and confirm a follow-up opens a ticket in Zendesk.
</Check>

## Use it

Enable [Create ticket](/docs/build/workflows/tools/create-ticket) or [Get ticket status](/docs/build/workflows/tools/get-ticket-status) on a workflow **Tools** tab. Select this Zendesk connection. Both tools use the same selected ticket service. Leave the provider set to **Botcadence Ticket Service** to keep tickets inside Botcadence.

## Limits

* **Create ticket** needs a customer **email**.
* [Operate → Tickets](/docs/operate/tickets) still shows only Botcadence-native tickets.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Sign-in fails">
    Confirm the subdomain is correct and matches `yourcompany.zendesk.com`. Sign in again with an account that can create tickets in that Zendesk account.
  </Accordion>

  <Accordion title="The agent cannot create or look up tickets">
    Enable **Create ticket** and **Get ticket status**, and select this Zendesk connection. Confirm the Integrations row is **Connected**.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.