Zendesk

Get a paginated list of all tickets in Zendesk. Returns tickets with their status, priority, subject, requester, assignee, and other core fields. Use cursor-based pagination for large result sets. Note: For incremental exports of all tickets, consider using the Incremental Export API instead.

Search for tickets using Zendesk's powerful search query syntax. You can search by keywords, filter by status, priority, tags, dates, and more. Examples: 'printer' finds tickets with 'printer', 'status:open priority:high' finds open high-priority tickets, 'created>2024-01-01' finds recent tickets. Returns up to 1,000 results with pagination. Use this when you need to find specific tickets based on criteria.

Retrieve detailed information about a specific ticket by its ID. Returns complete ticket data including status, priority, subject, description, requester, assignee, collaborators, tags, custom fields, and timestamps. Use this when you need full details about a known ticket.

Create a new support ticket in Zendesk. You must provide a subject and description (as a comment). Optionally specify priority (urgent, high, normal, low), status (new, open, pending, hold, solved, closed), type (problem, incident, question, task), tags, assignee, and custom fields. The requester is typically the customer requesting support. Use this to create new support requests programmatically.

Update an existing ticket's properties and optionally add a comment. You can modify status, priority, subject, assignee, tags, custom fields, and more. To add a comment to the ticket, include the comment_body parameter. Comments can be public (visible to end users) or private (agent-only). Use this to change ticket properties or add follow-up messages.

Permanently delete a ticket from Zendesk. This action cannot be undone. Use with caution. Tickets are typically solved or closed rather than deleted. Only use this for test tickets or spam. Requires appropriate permissions.

Retrieve all comments (conversation history) for a specific ticket. Comments include messages from the requester, agents, and collaborators. Each comment shows the author, timestamp, body text, and whether it's public or private. Comments are ordered chronologically. Use this to review the full conversation history of a ticket.

Add a new comment to an existing ticket. This is an alternative to using Update Ticket for adding comments. You can specify whether the comment is public (visible to the requester) or private (agent-only internal note). Use this to respond to tickets or add internal notes.

Get a paginated list of all users in Zendesk. Users can be end users (customers), agents, or administrators. Filter by role to get specific user types. Returns user details including name, email, role, organization, and activity status. Use cursor-based pagination for large user lists.

Search for users by query string. Searches across user name, email, phone, and other fields. Returns matching users with their details. Use this when you need to find specific users but don't have their ID. Example queries: email address, phone number, or partial name.