FruxonDocs

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-company part of your-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

  1. Open your agent in Agent Studio
  2. In the Integrations panel, click Add Integration Config
  3. Select Zendesk from the integration list
  4. Give the config a display name (e.g., "Zendesk - Support")
  5. Enter your Subdomain
  6. Enter your email and API token (Basic Auth)
  7. Save the agent revision

Using in Your Agent

  1. In an Agent Step, attach Zendesk tools from the tools panel
  2. The agent uses your integration config for all Zendesk API calls
  3. Tools are referenced as zendesk.list_tickets, zendesk.create_ticket, etc.

Available Tools

ToolDescriptionAction Type
list_ticketsList ticketsReadOnly
get_ticketGet a specific ticketReadOnly
searchSearch across tickets, users, and organizationsReadOnly
create_ticketCreate a ticketReversible
update_ticketUpdate a ticketReversible
add_ticket_commentAdd a comment to a ticketIrreversible
list_ticket_commentsList comments on a ticketReadOnly
search_usersSearch usersReadOnly
get_userGet a specific userReadOnly
get_current_userGet the current authenticated userReadOnly
list_organizationsList organizationsReadOnly
get_organizationGet a specific organizationReadOnly
list_groupsList groupsReadOnly
list_ticket_fieldsList ticket fieldsReadOnly

On this page