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 withguildServiceTool() 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 ownguildServiceTool("zendesk", ...) entry. Commonly used tools include zendesk_list_tickets, zendesk_create_ticket, zendesk_update_ticket, and zendesk_search.