Zendesk

Connect to Zendesk. Manage customer support tickets, users, organizations, and help desk operations

Supports authentication: API Key

Set up the agent connector

Register your Zendesk API credentials with Scalekit so it can authenticate requests on your behalf. You’ll need your Zendesk subdomain, email address, and an API token from your Zendesk Admin Center.

1. Generate an API token

   • In your Zendesk Admin Center, go to Apps and integrations → APIs → Zendesk API.

   • Under Settings, enable Token access.

     

   • Click Add API token, enter a description, and click Create.

   • Copy the token — it is only shown once.

2. Create a connection

   In Scalekit dashboard, go to Agent Auth → Create Connection. Find Zendesk and click Create.

3. Create a connected account

   Go to Connected Accounts for your Zendesk connection and click Add account. Fill in the required fields:

   • Your User’s ID — a unique identifier for the user in your system

   • Zendesk Domain — your full Zendesk domain (e.g., yourcompany.zendesk.com)

   • Email Address — the Zendesk account email address

   • API Token — the token you copied in step 1

   • Click Save.

     

Tool list

zendesk_ticket_create

Create a new support ticket in Zendesk. Requires a comment/description and optionally a subject, priority, assignee, and tags.

Name	Type	Required	Description
comment_body	string	Yes	The description or first comment of the ticket
subject	string	No	The subject/title of the ticket
status	string	No	Ticket status: new, open, pending, hold, solved, or closed
priority	string	No	Ticket priority: urgent, high, normal, or low
type	string	No	Ticket type: problem, incident, question, or task
assignee_email	string	No	Email of the agent to assign the ticket to
tags	array<string>	No	List of tags to apply to the ticket

zendesk_ticket_update

Update an existing Zendesk ticket. Change status, priority, assignee, subject, tags, or any other writable ticket field.

Name	Type	Required	Description
ticket_id	number	Yes	The ID of the ticket to update
status	string	No	Ticket status: new, open, pending, hold, solved, or closed
priority	string	No	Ticket priority: urgent, high, normal, or low
subject	string	No	New subject/title for the ticket
type	string	No	Ticket type: problem, incident, question, or task
assignee_email	string	No	Email of the agent to assign the ticket to
assignee_id	number	No	ID of the agent to assign the ticket to
group_id	number	No	ID of the group to assign the ticket to
tags	array<string>	No	List of tags to set on the ticket (replaces existing tags)

zendesk_ticket_reply

Add a public reply or internal note to a Zendesk ticket. Set public to false for internal notes visible only to agents.

Name	Type	Required	Description
ticket_id	number	Yes	The ID of the ticket to reply to
body	string	Yes	The reply message content (plain text, markdown supported)
public	boolean	No	true for a public reply, false for an internal note (default: true)

zendesk_ticket_get

Retrieve details of a specific Zendesk ticket by ID. Returns ticket properties including status, priority, subject, requester, assignee, and timestamps.

Name	Type	Required	Description
ticket_id	number	Yes	The ID of the ticket to retrieve
include	string	No	Comma-separated list of sideloads to include (e.g., users, groups, organizations)

zendesk_tickets_list

List tickets in Zendesk with sorting and pagination. Returns tickets for the authenticated agent’s account.

Name	Type	Required	Description
page	number	No	Page number for pagination
per_page	number	No	Number of tickets per page (max 100)
sort_by	string	No	Field to sort by: created_at, updated_at, priority, status, ticket_type
sort_order	string	No	Sort direction: asc or desc (default: desc)

zendesk_search_tickets

Search Zendesk tickets using a query string. Supports Zendesk’s search syntax (e.g., type:ticket status:open). Returns up to 1000 results with pagination.

Name	Type	Required	Description
query	string	Yes	Search query string using Zendesk search syntax (e.g., type:ticket status:open assignee:me)
page	number	No	Page number for pagination
per_page	number	No	Number of results per page (max 100)
sort_by	string	No	Field to sort results by (updated_at, created_at, priority, status, ticket_type)
sort_order	string	No	Sort direction: asc or desc (default: desc)

zendesk_ticket_comments_list

Retrieve all comments (public replies and internal notes) for a specific Zendesk ticket. Returns comment body, author, timestamps, and attachments.

Name	Type	Required	Description
ticket_id	number	Yes	The ID of the ticket whose comments to list
include	string	No	Sideloads to include. Use users to include user details for email CCs
include_inline_images	boolean	No	When true, inline images are listed as attachments (default: false)
sort_order	string	No	Sort direction for comments: asc or desc (default: asc)

zendesk_user_create

Create a new user in Zendesk. Can create end-users (customers), agents, or admins. Email is required for end-users.

Name	Type	Required	Description
name	string	Yes	Full name of the user
email	string	No	Primary email address of the user
role	string	No	User role: end-user, agent, or admin (default: end-user)
organization_id	number	No	ID of the organization to associate the user with
phone	string	No	Primary phone number in E.164 format (e.g., +15551234567)
verified	boolean	No	Whether the user’s identity is verified (default: false)

zendesk_user_get

Retrieve details of a specific Zendesk user by ID. Returns user profile including name, email, role, organization, and account status.

Name	Type	Required	Description
user_id	number	Yes	The ID of the user to retrieve
include	string	No	Comma-separated list of sideloads to include

zendesk_users_list

List users in Zendesk. Filter by role (end-user, agent, admin) with pagination support.

Name	Type	Required	Description
page	number	No	Page number for pagination
per_page	number	No	Number of users per page (max 100)
role	string	No	Filter by role: end-user, agent, or admin
sort	string	No	Field to sort by; prefix with - for descending (e.g., -created_at)

zendesk_organization_get

Retrieve details of a specific Zendesk organization by ID. Returns organization name, domain names, tags, notes, shared ticket settings, and custom fields.

Name	Type	Required	Description
organization_id	number	Yes	The ID of the organization to retrieve
include	string	No	Additional related data to include (e.g., lookup_relationship_fields)

zendesk_organizations_list

List all organizations in Zendesk with pagination support.

Name	Type	Required	Description
page	number	No	Page number for pagination
per_page	number	No	Number of organizations per page (max 100)

zendesk_views_list

List ticket views in Zendesk. Views are saved filters for organizing tickets by status, assignee, tags, and more.

Name	Type	Required	Description
page	number	No	Page number for pagination
per_page	number	No	Number of views per page (max 100)
access	string	No	Filter by access level: personal, shared, or account
sort_by	string	No	Field to sort by: title, updated_at, created_at, or position
sort_order	string	No	Sort direction: asc or desc

zendesk_groups_list

List all groups in Zendesk. Groups are used to organize agents and route tickets.

Name	Type	Required	Description
page	number	No	Page number for pagination
per_page	number	No	Number of groups per page (max 100)