Zendesk

The Zendesk toolkit integrates Arcade with Zendesk's support and help-center platform, enabling agents and applications to manage tickets, comments, and knowledge base articles on behalf of authenticated users.

Capabilities

• Ticket management: List tickets with offset-based pagination, mark tickets as solved with optional final comments, and retrieve direct html_url links to tickets in the Zendesk UI.
• Ticket comments: Add new comments to existing tickets and fetch the full comment thread (including the original description, author IDs, timestamps, visibility flags, and file attachments).
• Knowledge base search: Search published Help Center articles by query, labels, or date filters — all combinable in a single call — with offset-based pagination.
• Identity & account context: Retrieve the authenticated user's profile, role, organization, and Zendesk account details via WhoAmI.

OAuth

This toolkit uses OAuth 2.0 to authenticate users with Zendesk. See the Zendesk auth provider docs for setup instructions, including configuring your Zendesk OAuth app and registering it with Arcade.

Secrets

• ZENDESK_SUBDOMAIN: Your Zendesk account subdomain — the {subdomain} portion of https://{subdomain}.zendesk.com. This is not a credential but a required routing value that tells the toolkit which Zendesk instance to target. You can find it by logging into your Zendesk account and checking the URL in your browser. Every Zendesk account has a unique subdomain assigned at sign-up; it is visible under Admin Center → Account → Branding or simply from your browser's address bar when logged in.

For guidance on configuring secrets in Arcade, see the Arcade secrets docs. You can also manage secrets directly at https://api.arcade.dev/dashboard/auth/secrets.