> For the complete documentation index, see [llms.txt](https://notara-1.gitbook.io/notara-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://notara-1.gitbook.io/notara-docs/connectors/zendesk.md).

# Zendesk

The Zendesk connector gives the agent access to your support tickets, customer conversations, user accounts, and Help Center articles — so the team can query support data without switching tools.

## What It Enables

| Tool                          | Capability | Description                                                                        |
| ----------------------------- | ---------- | ---------------------------------------------------------------------------------- |
| `search_tickets`              | `read`     | Search tickets using Zendesk query syntax (status, priority, tags, assignee, date) |
| `get_ticket`                  | `read`     | Get one ticket including its original description                                  |
| `list_ticket_comments`        | `read`     | Read the full conversation thread on a ticket                                      |
| `list_users`                  | `read`     | List users to resolve requester and assignee IDs to names                          |
| `list_organizations`          | `read`     | List customer organizations and their domain mappings                              |
| `search_help_center_articles` | `read`     | Full-text search your Help Center knowledge base                                   |

## Setup

**Required:** Zendesk API token, the agent email it belongs to, and your subdomain.

**Where to find it:** In Zendesk, go to **Admin Center → Apps and integrations → APIs → Zendesk API** and create an API token.

1. In the Notara dashboard, go to **Tools**.
2. Click the **Zendesk** tile.
3. Enter your **subdomain** (the part before `.zendesk.com`), the **agent email**, and the **API token**.
4. Click **Verify & Save**.

Your API token is encrypted at rest with AES-256-GCM.

## Example Prompts

> "How many urgent open tickets do we have right now?"

> "Show me all tickets from Acme Corp that are unresolved."

> "What does our Help Center say about refund policy?"