Connect your own Zendesk account (API token or OAuth) to manage customer support end to end: tickets (create/update/comment/bulk/import/merge/audits), users and organizations (CRUD, membership, identities, merge), business rules (triggers, automations, macros, views), SLA policies, satisfaction ratings, side conversations, tags, custom ticket/user/organization fields, attachments, unified Search, Custom Objects, Webhooks, Help Center (Guide) articles/sections/categories, and read-only Talk (Voice) reporting -- plus bulk operations and a support health audit. Uses your own Zendesk credentials -- nothing is hosted or proxied by Imperal beyond the request itself. Note: covers Support (Ticketing) API v2, Guide API, Webhooks API, Custom Objects API and read-only Talk API; Sell (Sales CRM), Sunshine Conversations, Chat (Zopim), QA, WFM, and Explore are separate Zendesk products and out of scope.
Every capability exposed by Zendesk, metered per action and guarded by the two-step safety protocol.
connect_zendeskwriteConnect your own Zendesk account by saving its subdomain plus either an API token (email + token) or an OAuth access token, after checking the credentials actually work.
disconnect_zendeskdestructiveDisconnect a Zendesk account: deletes the saved credentials. Nothing in Zendesk itself is changed.
list_connectionsreadList the connected Zendesk accounts.
list_ticketsreadList tickets in the connected Zendesk account, optionally filtered by organization or view.
get_ticketreadRead one ticket in full by its numeric id.
create_ticketwriteCreate a new support ticket, optionally creating the requester if their email is new.
update_ticketwriteUpdate selected fields of an existing ticket (status, priority, assignment, subject, tags) and optionally add a comment.
add_commentwriteAdd a public reply or an internal note to an existing ticket.
delete_ticketdestructivePermanently delete a ticket. Zendesk keeps it recoverable in the Deleted Tickets view for a limited time before purge.
merge_ticketswriteMerge one or more source tickets into a target ticket -- their content is appended and the sources are closed.
bulk_update_ticketswriteUpdate the same status/priority/assignee/tags on up to 100 explicit tickets in one call.
bulk_delete_ticketsdestructivePermanently delete up to 100 explicit tickets in one call. Cannot be undone through the API.
import_ticketwriteImport a historical ticket (e.g. migrating from another helpdesk) preserving its original creation timestamp.
get_ticket_auditsreadRead the full change history (audits) of a ticket -- every event recorded against it.
list_usersreadList users (agents, admins, and end-users) in the connected Zendesk account.
get_userreadRead one user in full by their numeric id.
create_userwriteCreate a new user (end-user, agent, or admin) in the connected Zendesk account.
update_userwriteUpdate selected fields of an existing user. Only given fields change.
delete_userdestructivePermanently delete a user. Cannot be undone.
merge_usersdestructiveMerge one user into another -- the source user's tickets/history move to the target and the source is deleted.
list_user_identitiesreadList a user's identities -- emails, phones, and social/SSO logins, and which is primary/verified.
list_organizationsreadList organizations in the connected Zendesk account.
get_organizationreadRead one organization in full by id.
create_organizationwriteCreate a new organization.
update_organizationwriteUpdate selected fields of an existing organization. Only given fields change.
delete_organizationdestructivePermanently delete an organization. Cannot be undone.
list_organization_membershipsreadList which users belong to which organizations.
create_organization_membershipwriteAdd a user to an organization.
delete_organization_membershipwriteRemove a user from an organization.
list_groupsreadList agent groups configured in the connected Zendesk account.
get_groupreadRead one agent group in full by id.
create_groupwriteCreate a new agent group.
update_groupwriteUpdate selected fields of an existing agent group. Only given fields change.
delete_groupdestructivePermanently delete an agent group. Cannot be undone.
list_group_membershipsreadList which agents belong to which groups.
create_group_membershipwriteAdd an agent to a group.
delete_group_membershipwriteRemove an agent from a group.
list_business_rulesreadList triggers, automations, macros, or views in the connected Zendesk account (choose kind via rule_kind param on other calls; this lists triggers by default).
get_business_rulereadRead one trigger in full by its numeric id, including its raw conditions/actions JSON.
create_triggerwriteCreate a new trigger: an automatic action that fires the moment a ticket is created or updated and matches its conditions.
update_triggerwriteUpdate selected fields of an existing trigger. Only given fields change.
delete_business_ruledestructivePermanently delete a trigger, automation, macro, or view by its numeric id (endpoint inferred: tries trigger, then automation, then macro, then view). Cannot be undone.
create_automationwriteCreate a new automation: a time-based rule Zendesk evaluates hourly against ticket conditions.
update_automationwriteUpdate selected fields of an existing automation. Only given fields change.
create_macrowriteCreate a new macro: a set of ticket actions an agent applies with one click.
update_macrowriteUpdate selected fields of an existing macro. Only given fields change.
apply_macroreadPreview what a macro would change on a ticket (or a blank ticket) without actually applying it.
create_viewwriteCreate a new view: a saved ticket filter shown as a list in the agent workspace.
update_viewwriteUpdate selected fields of an existing view. Only given fields change.
execute_viewreadRun a view right now and return the tickets it currently matches.
list_sla_policiesreadList SLA policies configured in the connected Zendesk account.
create_sla_policywriteCreate a new SLA policy defining response/resolution time targets for matching tickets.
update_sla_policywriteUpdate selected fields of an existing SLA policy.
delete_sla_policydestructivePermanently delete an SLA policy. Cannot be undone.
list_satisfaction_ratingsreadList customer satisfaction (CSAT) ratings on the connected Zendesk account.
create_satisfaction_ratingwriteRate a solved ticket's support experience as 'good' or 'bad', optionally with a comment.
list_side_conversationsreadList side conversations (internal/external threads split off a ticket) on one ticket.
create_side_conversationwriteStart a new side conversation (email thread split off a ticket) to loop in an external party without cluttering the main ticket.
reply_side_conversationwritePost a reply message into an existing side conversation thread.
set_ticket_tagswriteReplace a ticket's full tag list.
add_ticket_tagswriteAdd tags to a ticket's existing tags (does not remove any).
remove_ticket_tagswriteRemove specific tags from a ticket.
autocomplete_tagsreadAutocomplete tags used across the account by partial text match.
list_custom_fieldsreadList custom field definitions for tickets, users, or organizations.
create_custom_fieldwriteCreate a new custom field on tickets, users, or organizations.
update_custom_fieldwriteUpdate selected fields of an existing custom field definition.
delete_custom_fielddestructivePermanently delete a custom field definition. Existing ticket/user/organization data in that field is lost.
upload_attachmentwriteUpload a file to Zendesk (base64-encoded) so it can be attached to a ticket comment via its returned token.
searchreadSearch across tickets, users, organizations, and groups using Zendesk's unified search syntax (e.g. 'type:ticket status:open priority:urgent').
create_custom_objectwriteDefine a new Zendesk custom object type (a custom data model, e.g. 'invoice' or 'asset').
list_custom_objectsreadList custom object types defined in the connected Zendesk account.
delete_custom_objectdestructivePermanently delete a custom object type and every record of it. Cannot be undone.
list_custom_object_recordsreadList records of a custom object type.
create_custom_object_recordwriteCreate a new record of a custom object type.
update_custom_object_recordwriteUpdate selected fields on an existing custom object record.
delete_custom_object_recorddestructivePermanently delete a custom object record. Cannot be undone.
create_webhookwriteSubscribe to Zendesk events (e.g. ticket.created, ticket.status_changed) -- Zendesk will POST to your HTTPS endpoint.
list_webhooksreadList webhook subscriptions configured on the connected Zendesk account.
update_webhookwriteUpdate an existing webhook's name, endpoint, subscriptions, or status. Only given fields change.
delete_webhookdestructivePermanently remove a webhook subscription. Cannot be undone.
test_webhookwriteSend a test event through a saved webhook (or an ad-hoc unsaved config) so you can confirm your endpoint receives it.
list_hc_categoriesreadList Help Center categories in the connected Zendesk account.
create_hc_categorywriteCreate a new Help Center category.
update_hc_categorywriteUpdate an existing Help Center category's name and/or description.
delete_hc_categorydestructivePermanently delete a Help Center category. Cannot be undone.
list_hc_sectionsreadList Help Center sections, optionally filtered to one category.
create_hc_sectionwriteCreate a new Help Center section inside a category.
update_hc_sectionwriteUpdate an existing Help Center section's name and/or description.
delete_hc_sectiondestructivePermanently delete a Help Center section. Cannot be undone.
list_hc_articlesreadList Help Center articles, optionally filtered by section or labels.
get_hc_articlereadRead one Help Center article in full, including its body content.
create_hc_articlewriteCreate a new Help Center article in a section, as a draft by default.
update_hc_articlewriteUpdate an existing Help Center article's title, body, draft state, and/or labels.
delete_hc_articledestructivePermanently delete a Help Center article. Cannot be undone.
search_hc_articlesreadSearch Help Center content (articles) by free-text query, optionally restricted to a locale or category.
list_talk_phone_numbersreadList phone numbers provisioned on the connected Zendesk Talk account.
list_talk_linesreadList Talk lines configured on the connected Zendesk account.
list_talk_agent_statusesreadRead current Talk availability status for every agent (e.g. online, away, offline, on a call).
create_callback_requestwriteQueue a callback request on a Talk line for a customer's phone number, optionally linked to an existing ticket.
audit_support_healthreadBuild one aggregated health report across the connected Zendesk account: open ticket count, overdue-SLA count, unassigned count, CSAT score, and breakdowns by priority/status.
get_sla_breach_reportreadScan open tickets and flag every SLA metric that has already breached (past its target time).
get_agent_workload_reportreadSummarize open/pending ticket counts per assigned agent, optionally restricted to one group.
find_stale_ticketsreadFlag open tickets that have not been updated in at least the given number of days.
get_csat_summaryreadSummarize customer satisfaction ratings (good/bad/offered counts and score) over the given period.
bulk_close_ticketswriteClose up to 100 explicit tickets in one call -- a convenience wrapper over bulk_update_tickets with status fixed to 'closed'.
More extensions in Customer Support ready to enable in one click.
Enable Zendesk in your Imperal workspace in one click - 10,000 free starter credits included.