Zendesk
Zendesk Support API integration for managing tickets, users, organizations, and groups
The Zendesk integration lets your agents manage support tickets, search users, and work with organizations and groups.
Prerequisites
You need:
- Zendesk subdomain — Your Zendesk subdomain (the
your-companypart ofyour-company.zendesk.com). - Email + API Token — Generate an API token in Zendesk under Admin → Channels → API. Authentication uses your email address and the API token.
Setup
- Open your agent in Agent Studio
- In the Integrations panel, click Add Integration Config
- Select Zendesk from the integration list
- Give the config a display name (e.g., "Zendesk - Support")
- Enter your Subdomain
- Enter your email and API token (Basic Auth)
- Save the agent revision
Using in Your Agent
- In an Agent Step, attach Zendesk tools from the tools panel
- The agent uses your integration config for all Zendesk API calls
- Tools are referenced as
zendesk.list_tickets,zendesk.create_ticket, etc.
Available Tools
| Tool | Description | Action Type |
|---|---|---|
list_tickets | List tickets | ReadOnly |
get_ticket | Get a specific ticket | ReadOnly |
search | Search across tickets, users, and organizations | ReadOnly |
create_ticket | Create a ticket | Reversible |
update_ticket | Update a ticket | Reversible |
add_ticket_comment | Add a comment to a ticket | Irreversible |
list_ticket_comments | List comments on a ticket | ReadOnly |
search_users | Search users | ReadOnly |
get_user | Get a specific user | ReadOnly |
get_current_user | Get the current authenticated user | ReadOnly |
list_organizations | List organizations | ReadOnly |
get_organization | Get a specific organization | ReadOnly |
list_groups | List groups | ReadOnly |
list_ticket_fields | List ticket fields | ReadOnly |