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 Integrations from the sidebar
  2. Select Zendesk from the catalog
  3. Click Add Integration Config
  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 config

Using in Your Agent

  1. Open your agent in Agent Studio and select an Agent Step
  2. Under Attached Integration Configurations, click Attach configuration and choose your config
  3. Attach Zendesk tools from the tools panel
  4. 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