---
title: "Connect Zendesk"
description: "Open a ticket in Zendesk whenever your agent hands a chat to a person."
source: https://hiy.ai/docs/connectors/zendesk
---

# Connect Zendesk

Connect Zendesk once for the whole workspace. Your agent can then open a ticket each time it hands a chat to a person.

### Connect Zendesk

1. **Create an API token in Zendesk** — In Zendesk, open **Admin Center › Apps and integrations › APIs › API tokens** and press **Add API token**. Copy the token, because Zendesk shows it once. Token access must be on; [Zendesk's guide](https://support.zendesk.com/hc/en-us/articles/4408889192858-Managing-access-to-the-Zendesk-API) says how.

2. **Paste your subdomain, email and token** — Press **Connect Zendesk** in **Integrations**. Type your **Subdomain** (the part before `.zendesk.com`), the **Agent email** the token belongs to and the **API token**. hiy checks them before it saves. ![The Connect Zendesk sheet with Subdomain, Agent email and API token](https://hiy.ai/docs-shots/connectors/zendesk-connect.webp) *Integrations › Zendesk*

3. **Turn on tickets for an agent** — Open the agent's **Settings › Handover** and switch on [**Ticket on handover**](/docs/handover#ticket-on-handover). ![The Handover group in an agent's Settings: When to hand over, Who it reaches, What it says while handing over, Safety, Ticket on handover and Team hours](https://hiy.ai/docs-shots/handover/settings.webp) *Agents › your agent › Settings › Handover*

**Tip:** Test only rehearses a handover, so no ticket opens there. Hand over a chat from your own site to see one.

**Good to know:**

- Use a dedicated Zendesk agent for hiy. It must also be able to read your Help Center if you [import it](/docs/help-centre).
- hiy checks the connection once a day. If Zendesk stops accepting it, owners and admins get one email.
- **Reconnect** keeps each agent's ticket switch and your actions.

## Related

- [Integrations](/docs/connectors) — Connect your helpdesk, Slack and Stripe once, and let your agents use them.

- [Handing over to a person](/docs/handover) — When your agent hands a chat to a person, who it reaches, and when it does so by itself.

- [Help centre import](/docs/help-centre) — Import the published articles of your Zendesk or Intercom help centre by section, with the connection you already have. Restricted articles stay for Team agents.