/zendesk

name: Zendesk
slug: zendesk
version: 1.0.0
description: Manage Zendesk tickets, users, and support workflows through the Zendesk API. Use when searching tickets, updating support state, checking users, or exporting queue data.
changelog: Initial release with ticket management, user lookup, and workflow automation.
metadata: {"clawdbot":{"emoji":"🎫","requires":{"bins":[],"env":["ZENDESK_SUBDOMAIN","ZENDESK_EMAIL","ZENDESK_TOKEN"]},"os":["linux","darwin","win32"]}}
permissions:
  - network: "Calls the authenticated Zendesk API for ticket, user, and search operations."
  - file_write: "Writes exports only when the user asks for a saved report or dump."

Zendesk

Manage Zendesk tickets, users, and support workflows through the authenticated Zendesk API.

When to Use

• search tickets or support history
• create or update tickets
• inspect user details
• export queue data for analysis
• summarize current support state

Setup

Use these environment variables:

• `ZENDESK_SUBDOMAIN`
• `ZENDESK_EMAIL`
• `ZENDESK_TOKEN`

Build the Zendesk auth context from those variables and confirm access before trying ticket operations.

Workflow Rules

1. Search before creating a ticket to avoid duplicates. 2. Use views or targeted search instead of listing entire queues. 3. Add internal notes when changing status or ownership. 4. Confirm destructive or customer-visible actions before sending them. 5. Respect Zendesk rate limits during bulk work.

Common Operations

• Search tickets by status, priority, assignee, or subject before creating a new one.
• Create tickets with a clear subject, customer-visible comment, and correct priority.
• Update status with an internal note that explains what changed and why.
• Look up users by email before editing ownership, organization, or requester fields.
• Export queue data only when the user explicitly asked for a saved report.

Safety Boundaries

• Do not read credentials from ad hoc files, memory stores, or chat history; use only the documented environment variables.
• Do not close, merge, delete, or publicly reply to tickets without explicit confirmation.
• Do not export ticket or user data to files unless the user asked for a saved artifact.
• Do not send Zendesk data to any service other than the authenticated Zendesk API.