Skip to main content
The Zendesk integration gives your agents access to Zendesk support tickets and customer data.
Zendesk is a dynamically resolved integration. Its operations are resolved from Zendesk’s OpenAPI specification at runtime, so agents do not import a Zendesk-specific package. Register the operations you need with guildServiceTool("zendesk", ...) from the Guild Agents SDK.

Authentication

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

Setup

1

Open Credentials

Go to Credentials in Guild.
2

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.

Usage

Zendesk is dynamically resolved, so you do not import a Zendesk-specific package. Register the operations your agent needs with guildServiceTool() from the Guild Agents SDK, passing zendesk as the service name. Guild resolves each operation against Zendesk’s OpenAPI specification and injects credentials through the connected account. Name each tool with the zendesk_ prefix to match the underlying operation — for example, the create_ticket operation becomes the zendesk_create_ticket tool.

Selecting specific tools

Agents perform better with fewer tools. Register only the operations your agent needs — add each one as its own guildServiceTool("zendesk", ...) entry. Commonly used tools include zendesk_list_tickets, zendesk_create_ticket, zendesk_update_ticket, and zendesk_search.