Zendesk

The Zendesk toolkit connects Arcade to Zendesk, enabling agents and apps to manage support tickets, retrieve conversation history, search the Help Center knowledge base, and inspect account context — all via OAuth-authenticated API calls.

Capabilities

• Ticket management: List tickets with offset-based pagination, add public or internal comments, and mark tickets as solved (with an optional closing comment). All ticket responses include a direct html_url link.
• Conversation retrieval: Fetch all comments on a ticket in chronological order, including the original description, author IDs, timestamps, public/internal flags, and file attachments.
• Knowledge base search: Search published Help Center articles by query text, label names, or date filters — combinable in a single call — with offset-based pagination.
• Account introspection: Retrieve the authenticated user's profile, role, organization, and Zendesk account context via WhoAmI.

OAuth

This toolkit uses OAuth 2.0 through the Arcade Zendesk auth provider. See the provider docs for setup details: https://docs.arcade.dev/en/references/auth-providers/zendesk

Secrets

• ZENDESK_SUBDOMAIN — Your Zendesk account subdomain (the {subdomain} portion of https://{subdomain}.zendesk.com). Find it by logging into your Zendesk account and inspecting the URL; it is the segment immediately before .zendesk.com. This value is required so the toolkit knows which Zendesk instance to target for every API call. It is not a credential — it is an account identifier — but it must be configured as a secret in Arcade.

Configure secrets at https://docs.arcade.dev/en/guides/create-tools/tool-basics/create-tool-secrets or via the Arcade dashboard at https://api.arcade.dev/dashboard/auth/secrets.