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

# Zendesk

> Give agents access to Zendesk support tickets and customer data.

The `@guildai-services/guildai~zendesk` package gives your agents access to Zendesk support tickets and customer data through Guild's Zendesk integration.

## Authentication

* **Type:** API token
* **Token management:** API tokens do not expire

### Setup

<Steps>
  <Step title="Open Credentials">Go to **Credentials** in Guild.</Step>
  <Step title="Connect Zendesk">Click **Zendesk** and enter your Zendesk subdomain (e.g. `yourcompany`), agent email address, and API token. Generate the token from Admin Center → Apps and Integrations → APIs → Zendesk API.</Step>
</Steps>

## Usage

```typescript theme={null}
import { zendeskTools } from "@guildai-services/guildai~zendesk"
import { llmAgent } from "@guildai/agents-sdk"

export default llmAgent({
  description: "An agent that manages Zendesk support tickets",
  tools: { ...zendeskTools },
})
```

### Selecting specific tools

Tools are named with the `zendesk_` prefix. Use `pick()` to include only what your agent needs. Commonly used tools include `zendesk_list_tickets`, `zendesk_create_ticket`, `zendesk_update_ticket`, and `zendesk_search`.

```typescript theme={null}
import { zendeskTools } from "@guildai-services/guildai~zendesk"
import { llmAgent, pick } from "@guildai/agents-sdk"

export default llmAgent({
  description: "An agent that triages incoming support tickets",
  tools: {
    ...pick(zendeskTools, [
      "zendesk_list_tickets",
      "zendesk_create_ticket",
      "zendesk_update_ticket",
      "zendesk_search",
    ]),
  },
})
```