# How to integrate Zendesk MCP with Pydantic AI

```json
{
  "title": "How to integrate Zendesk MCP with Pydantic AI",
  "toolkit": "Zendesk",
  "toolkit_slug": "zendesk",
  "framework": "Pydantic AI",
  "framework_slug": "pydantic-ai",
  "url": "https://composio.dev/toolkits/zendesk/framework/pydantic-ai",
  "markdown_url": "https://composio.dev/toolkits/zendesk/framework/pydantic-ai.md",
  "updated_at": "2026-05-12T10:31:05.296Z"
}
```

## Introduction

This guide walks you through connecting Zendesk to Pydantic AI using the Composio tool router. By the end, you'll have a working Zendesk agent that can create a new zendesk ticket for a customer, list all open tickets assigned to me, summarize this week's new zendesk tickets through natural language commands.
This guide will help you understand how to give your Pydantic AI agent real control over a Zendesk account through Composio's Zendesk MCP server.
Before we dive in, let's take a quick look at the key ideas and tools involved.

## Also integrate Zendesk with

- [ChatGPT](https://composio.dev/toolkits/zendesk/framework/chatgpt)
- [OpenAI Agents SDK](https://composio.dev/toolkits/zendesk/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/zendesk/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/zendesk/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/zendesk/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/zendesk/framework/codex)
- [Cursor](https://composio.dev/toolkits/zendesk/framework/cursor)
- [VS Code](https://composio.dev/toolkits/zendesk/framework/vscode)
- [OpenCode](https://composio.dev/toolkits/zendesk/framework/opencode)
- [OpenClaw](https://composio.dev/toolkits/zendesk/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/zendesk/framework/hermes-agent)
- [CLI](https://composio.dev/toolkits/zendesk/framework/cli)
- [Google ADK](https://composio.dev/toolkits/zendesk/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/zendesk/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/zendesk/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/zendesk/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/zendesk/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/zendesk/framework/crew-ai)

## TL;DR

Here's what you'll learn:
- How to set up your Composio API key and User ID
- How to create a Composio Tool Router session for Zendesk
- How to attach an MCP Server to a Pydantic AI agent
- How to stream responses and maintain chat history
- How to build a simple REPL-style chat interface to test your Zendesk workflows

## What is Pydantic AI?

Pydantic AI is a Python framework for building AI agents with strong typing and validation. It leverages Pydantic's data validation capabilities to create robust, type-safe AI applications.
Key features include:
- Type Safety: Built on Pydantic for automatic data validation
- MCP Support: Native support for Model Context Protocol servers
- Streaming: Built-in support for streaming responses
- Async First: Designed for async/await patterns

## What is the Zendesk MCP server, and what's possible with it?

The Zendesk MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Zendesk account. It provides structured and secure access to your helpdesk, so your agent can create tickets, retrieve ticket details, manage organizations, and streamline customer support workflows on your behalf.
- Automated ticket creation and management: Let your agent create new support tickets, update details, or delete tickets to keep your helpdesk organized and responsive.
- Advanced ticket search and retrieval: Quickly pull up lists of open, pending, or filtered tickets, or fetch specific ticket details for efficient support resolution.
- Organization management: Effortlessly create, retrieve, or delete organizations in your Zendesk account to keep customer data up to date.
- Account insights and user info: Have your agent fetch account owner information or organization details for better context in customer interactions.
- Scalable support automation: Use AI-powered workflows to triage, route, and manage high volumes of tickets without manual intervention.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `ZENDESK_APPLY_ZENDESK_MACRO` | Apply Zendesk Macro Preview | Preview how a Zendesk macro would affect a ticket without actually applying it. Returns the ticket object as it would appear after the macro is applied, showing any changes to fields, comments, status, or other properties. Use this action to review macro changes before applying them to ensure the outcome is as expected. |
| `ZENDESK_AUTOCOMPLETE_PROBLEMS` | Autocomplete Problems | Autocomplete problems in Zendesk. Use when you need to find problem suggestions based on a partial search text for ticket categorization or troubleshooting. |
| `ZENDESK_AUTOCOMPLETE_USERS` | Autocomplete Users | Search for Zendesk users by name prefix using the POST /api/v2/users/autocomplete endpoint. Returns an array of users whose name starts with the provided query. Use when you need to find users by name prefix for quick user lookup and autocomplete functionality. |
| `ZENDESK_CHECK_HOST_MAPPING_VALIDITY_FOR_EXISTING_BRAND` | Check Host Mapping Validity for Existing Brand | Check the host mapping validity for an existing brand in Zendesk. Returns the current CNAME record, expected CNAME values, validity status, and the reason for validity or invalidity. Use this action when you need to verify that DNS records are correctly configured for an existing brand that has already been created in Zendesk. This action requires a brand ID rather than subdomain/host_mapping parameters. |
| `ZENDESK_COUNT_DELETED_USERS` | Count Deleted Users | Count deleted users in Zendesk. Returns the total number of deleted users. Use when you need to know how many users have been deleted for reporting, cleanup, or operational purposes. |
| `ZENDESK_COUNT_USER_CCD_TICKETS` | Count User CCD Tickets | Count tickets where the specified user is CCD (carbon copy distribution). Returns an approximate count of tickets where the user appears in the CCD field. Use when you need to know how many tickets a user is copied on for reporting or operational purposes. |
| `ZENDESK_COUNT_ZENDESK_CUSTOM_OBJECT_RECORDS` | Count Custom Object Records | Count the number of records in a specific Zendesk custom object. Use when you need to determine the total number of records for a custom object type, which is useful for reporting, capacity planning, or validation before creating new records. This is a read-only, idempotent operation. Example use cases: - Check if a custom object has records before deleting - Get record count for reporting dashboards - Verify capacity before bulk operations |
| `ZENDESK_COUNT_ZENDESK_ORGANIZATIONS` | Count Zendesk Organizations | Count the number of organizations in Zendesk. Returns an approximate count of organizations with the timestamp of when the count was last calculated. This is a read-only, idempotent operation. Use when you need to know the total number of organizations for reporting, capacity planning, or operational purposes. For detailed per-organization information, use ZENDESK_GET_ALL_ZENDESK_ORGANIZATIONS instead. |
| `ZENDESK_CREATE_ACCESS_RULE` | Create Access Rule | Create an access rule for a custom object in Zendesk. Access rules control which users can view or modify custom object records based on conditions. Use when you need to set up data access policies for custom objects, such as limiting access to records created by the current user or records assigned to specific groups. Returns the created access rule with its ID, title, description, conditions, and timestamps. |
| `ZENDESK_CREATE_APPS_INSTALLATION` | Install Zendesk App | Install a Zendesk app in the account. Use when you need to add an app from the Zendesk marketplace or a private app to your Zendesk instance. You must provide the app_id and settings. This action is irreversible once installed. |
| `ZENDESK_CREATE_APPS_NOTIFY` | Send Notification to App | Send a notification to currently open instances of a Zendesk app. Use when you need to push real-time notifications or data to a Zendesk app that is currently open in an agent's interface. The notification triggers an event in the app, which can then respond with custom behavior (e.g., display a popup, update UI, trigger a workflow). Only works with apps that are currently open in the Zendesk interface. |
| `ZENDESK_CREATE_AUTOCOMPLETE_TAGS` | Create Autocomplete Tags | Search for Zendesk tags using autocomplete via POST request body. Use when you need to find tag suggestions based on a partial tag name for tagging tickets or organizing content. |
| `ZENDESK_CREATE_AUTOMATION` | Create Automation | Create a new automation in Zendesk. Automations are business rules that automatically perform actions on tickets when certain conditions are met. Automations run server-side and don't require user interaction. Use this action when you need to: - Automatically assign tickets based on conditions - Change ticket priority/status based on rules - Add tags to tickets matching certain criteria - Notify agents or teams based on ticket properties - Implement escalation workflows Note: Automations must have at least one condition that is time-based (like created_at, updated_at) OR check one of: status, type, group_id, assignee_id, or requester_id. |
| `ZENDESK_CREATE_BOOKMARK` | Create Bookmark | Create a bookmark for a ticket in Zendesk. Bookmarks allow you to save references to tickets for quick access. Use this action when you need to: - Save a ticket for later reference - Mark an important ticket for quick access - Create a watchlist-like functionality for specific tickets |
| `ZENDESK_CREATE_COMMENT_REDACTION` | Redact Zendesk Comment | Redact sensitive content from a ticket comment in Zendesk using the Agent Workspace method. Use when you need to permanently remove or hide sensitive information such as personal data, credentials, or inappropriate content from ticket comments. This action is irreversible — redacted content cannot be recovered once removed. Note: Requires Agent Workspace to be enabled and (for Enterprise accounts) agents need a custom role with redaction permissions. Closed tickets cannot have comments redacted. |
| `ZENDESK_CREATE_CUSTOM_OBJECT_BULK_JOB` | Create Custom Object Bulk Job | Create a bulk job to perform batch operations (create, update, delete, upsert) on custom object records in Zendesk. Use when you need to process multiple records of a custom object type efficiently in a single API call. Returns a job ID for tracking the operation progress via GET /api/v2/custom_objects/{custom_object_key}/jobs/{job_id}. |
| `ZENDESK_CREATE_CUSTOM_OBJECT_RECORD` | Create Custom Object Record | Create a new record for a custom object in Zendesk. Use when you need to add a new entry to a custom object type. The record is identified by its unique ID returned in the response. This action creates a new custom object record and returns the complete record data including the generated ID and timestamps. |
| `ZENDESK_CREATE_CUSTOM_OBJECT_RECORD_ATTACHMENT` | Create Custom Object Record Attachment | Create an attachment for a custom object record in Zendesk. Use when you need to attach files (documents, images, etc.) to a custom object record. The file is uploaded as a multipart/form-data request. The response includes the attachment details and malware scan status. |
| `ZENDESK_CREATE_CUSTOM_STATUSES` | Create Custom Ticket Status | Create a new custom ticket status in Zendesk. Custom statuses allow agents to define more granular ticket states beyond the default status categories. Use when you need to add custom ticket workflow states to better reflect your support process. Both `agent_label`, `status_category`, `end_user_label`, and `description` are required. The status category determines which lifecycle phase the custom status belongs to. |
| `ZENDESK_CREATE_DELETION_SCHEDULE` | Create Deletion Schedule | Create a new deletion schedule in Zendesk that automatically deletes records matching specified conditions on a schedule. Deletion schedules are used for data retention and cleanup policies. Use this action when you need to: - Automatically clean up old closed tickets - Remove inactive users or attachments - Enforce data retention policies - Schedule periodic deletion of bot conversations Note: The 'object' field (entity type to delete) cannot be modified after creation. Use conditions to specify which records to delete - for time-based deletion, use 'duration_since_last_update' field with 'greater_than' operator and ISO 8601 duration values (e.g., 'P30D' for 30 days). |
| `ZENDESK_CREATE_DYNAMIC_CONTENT_ITEMS` | Create Zendesk Dynamic Content Item | Create a new dynamic content item with locale variants in Zendesk. Dynamic content items enable localized content for ticket fields, macros, and other text-based content. Use when setting up multilingual support or creating template content that varies by user locale. The item's name cannot be changed after creation. Ensure the name is descriptive and follows your naming conventions. |
| `ZENDESK_CREATE_DYNAMIC_CONTENT_ITEMS_VARIANTS` | Create Zendesk Dynamic Content Item Variant | Create a new locale variant for an existing dynamic content item in Zendesk. Use when you need to add support for a new locale to an existing dynamic content item. Note: You can only create one variant per locale per dynamic content item. Use the update action to modify existing variants. |
| `ZENDESK_CREATE_END_USER_IDENTITY` | Create End User Identity | Add an identity (email or phone) to an end user's profile in Zendesk. Use when you need to link a new email address or phone number to an existing end user account. |
| `ZENDESK_CREATE_GROUP_MEMBERSHIPS` | Create Zendesk Group Membership | Create a group membership in Zendesk, assigning an agent to a group. Use when you need to add an agent to a specific group for ticket routing, permissions, or team organization. The user_id and group_id are both required parameters. Note: The user must exist and have appropriate permissions to be assigned to groups. The group must also exist. |
| `ZENDESK_CREATE_IMPORTS_TICKETS_CREATE_MANY` | Bulk Import Tickets | Bulk import tickets into Zendesk by posting up to 100 ticket objects at a time. Use when migrating tickets from another system or creating multiple tickets in a single API call. The operation returns a job_status payload; the initial status is typically 'queued' or 'completed' for small batches. This action is useful for data migration, test data setup, and bulk ticket creation workflows. |
| `ZENDESK_CREATE_MANY_DYNAMIC_CONTENT_ITEMS_VARIANTS` | Create Many Dynamic Content Variants | Create many locale variants for an existing dynamic content item in Zendesk. Use when you need to add multiple language variants to a dynamic content item in a single operation. This action is efficient for bulk-adding translations to support multilingual content. This action is idempotent - running it multiple times with the same variants will create duplicate variants if they don't already exist. Consider listing existing variants first to avoid duplicates. |
| `ZENDESK_CREATE_MANY_TICKETS` | Create Many Zendesk Tickets | Create many tickets in Zendesk in a single request. Accepts an array of up to 100 ticket objects. The operation is handled asynchronously — a background job is queued and you receive a job_status payload with an initial status of 'queued' or 'working'. Poll the job_status URL or use ZENDESK_GET_APPS_JOB_STATUS to check for completion and view per-ticket results. Use when creating multiple tickets at once or seeding test data. This action is irreversible — tickets created cannot be easily undone once the job completes. Ensure the tickets list is accurate before submitting. |
| `ZENDESK_CREATE_MANY_USERS` | Create Many Zendesk Users | Create many users in Zendesk in a single request. Accepts up to 100 user objects. The operation is handled asynchronously — a background job is queued and you receive a job_status payload with an initial status of 'queued' or 'working'. Poll the job_status URL or use ZENDESK_GET_APPS_JOB_STATUS to check for completion and view per-user results. Use when onboarding multiple users at once or seeding test data. Note: This action is idempotent — re-running with the same external_ids may update existing users depending on Zendesk configuration. |
| `ZENDESK_CREATE_OBJECT_TRIGGER` | Create Object Trigger | Create a new trigger for a custom object in Zendesk. Custom object triggers are business rules that automatically perform actions when certain conditions are met on custom object records. Use this action when you need to: - Send notifications when custom object records are created or updated - Automatically update fields on custom object records - Add or remove tags based on custom object conditions - Implement automated workflows for custom object data This action is idempotent - creating a trigger with the same name multiple times will result in duplicate triggers unless the name is changed. |
| `ZENDESK_CREATE_ORGANIZATION_FIELD` | Create Organization Field | Create a custom organization field in Zendesk. Use when you need to add a new custom field type (such as text, dropdown, checkbox, date, etc.) to track additional organization attributes. The field key must be unique and can only contain letters, numbers, and underscores. |
| `ZENDESK_CREATE_ORGANIZATION_MEMBERSHIPS` | Create Organization Membership | Create a new organization membership in Zendesk by assigning a user to an organization. Use when you need to associate a user with an organization so they can access organization-specific tickets and data. Returns a 422 error if the user is already assigned to the organization. This action is idempotent in that creating a duplicate membership will fail with a specific error, but the operation itself is not naturally idempotent. |
| `ZENDESK_CREATE_ORGANIZATION_MEMBERSHIPS_CREATE_MANY` | Create Many Organization Memberships | Create multiple organization memberships in Zendesk by posting up to 100 membership objects at a time. Each membership links a user to an organization. Use when onboarding multiple users to organizations in bulk, such as during team migrations or organizational restructuring. The operation returns a job_status payload; the initial status is typically 'queued' for larger batches. |
| `ZENDESK_CREATE_ORGANIZATION_MERGE` | Merge Zendesk Organizations | Merge two Zendesk organizations by combining all users, tickets, and data from the losing organization into the winning organization. This action is irreversible — once merged, the losing organization and all its data cannot be recovered. Use when you need to consolidate duplicate organizations or combine organization data into a single organization. |
| `ZENDESK_CREATE_ORGANIZATIONS_TAGS` | Set Organization Tags | Set organization tags in Zendesk by making a POST request to replace the tags on an organization. Use when you need to categorize or label organizations with specific tags for filtering and organization purposes. This operation replaces all existing tags on the organization with the new set provided. Note: This action is not idempotent as it replaces existing tags rather than adding to them. |
| `ZENDESK_CREATE_ORGANIZATION_SUBSCRIPTION` | Create Organization Subscription | Create an organization subscription in Zendesk. This subscribes a user to receive notifications and updates related to a specific organization. Use when you need to add a user to an organization's subscription list so they can access organization-related resources and receive notifications. |
| `ZENDESK_CREATE_OR_UPDATE_MANY_USERS` | Create Or Update Many Users | Create or update multiple users in Zendesk in a single request. Use when you need to batch create or update up to 100 users at once. New users require a 'name' field; existing users are matched by 'id'. Returns a job_status with results for each operation. This action is idempotent — re-running with the same parameters will produce the same results. |
| `ZENDESK_CREATE_OR_UPDATE_ORGANIZATION` | Create Or Update Organization | Create or update a Zendesk organization in a single operation. If an organization with the same external_id already exists, it is updated. Otherwise, a new organization is created. Use when you need to ensure an organization exists without checking for duplicates first. Note: For updates, you must specify the external_id to match the existing organization. Name is not available as a matching criteria. |
| `ZENDESK_CREATE_OR_UPDATE_USER` | Create or Update User | Create or update a Zendesk user. If a user with the same email or external_id exists, it updates that user. Otherwise, it creates a new user. Use when you need to upsert user records - idempotent based on email or external_id matching. Returns 200 for existing users, 201 for newly created users. |
| `ZENDESK_CREATE_PUSH_NOTIFICATION_DEVICES_DESTROY_MANY` | Bulk Unregister Push Notification Devices | Bulk unregister push notification devices in Zendesk. This action is irreversible — the devices will be permanently removed from receiving push notifications and cannot be recovered once removed. Use when cleaning up obsolete device tokens or removing test devices from receiving push notifications. |
| `ZENDESK_CREATE_RESOURCE_COLLECTIONS` | Create Resource Collection | Create a resource collection in Zendesk. Use when you need to batch multiple operations on Zendesk resources (like tickets) into a single request. The API processes the collection as a background job and returns a job status object. Note: This action queues a background job. Poll the returned job_status.url to check when the collection has been processed. |
| `ZENDESK_CREATE_SIDE_CONVERSATION` | Create Side Conversation | Create a private side conversation on a Zendesk ticket. Side conversations are agent-to-agent communications that don't notify the customer. Use this action when you need to discuss a ticket privately with another agent, escalate to a specialist, or coordinate on sensitive issues without customer visibility. Recipients can include Zendesk users (by ID or email), Slack channels, support groups, or Microsoft Teams channels. |
| `ZENDESK_CREATE_SUPPORT_ADDRESS` | Create Support Address | Create a new support address (recipient address) in Zendesk. Use when you need to add a new email address for receiving support requests. The email address must follow Zendesk's format (`{local-part}@{accountname}.zendesk.com`) for internal addresses, or be an existing external email with forwarding properly configured. The created address will have verification statuses that indicate whether DNS records (CNAME, SPF) are properly configured. Note that you cannot change the email address of an existing support address after creation. |
| `ZENDESK_CREATE_SUSPENDED_TICKETS_EXPORT` | Export Suspended Tickets | Export Suspended Tickets from Zendesk Support. Use when you need to export all suspended tickets for compliance review, audit purposes, or data analysis. This action enqueues a job that creates a CSV file; when complete, Zendesk emails the requester a link to download the CSV. Suspended tickets are sorted by update timestamp in ascending order. Rate limited to one request per minute. Note: This action is read-only and returns the export job status. The actual CSV will be sent via email when the job completes. |
| `ZENDESK_CREATE_TICKET_CONTENT_PIN` | Create Ticket Content Pin | Create a ticket content pin in Zendesk. Content pins allow you to attach helpful resources like Help Center articles or external content directly to tickets for easy reference. Use this action when you need to: - Attach a Help Center article to a ticket for context - Pin an external knowledge base article to a ticket - Add relevant documentation or resources to a support ticket |
| `ZENDESK_CREATE_TICKET_FIELD` | Create Ticket Field | Create a custom ticket field in Zendesk with various field types. Use when you need to add a new custom field (such as text, dropdown, checkbox, date, numeric, regex-validated, or lookup) to capture additional information on tickets. The field title is required; description, required flag, and custom options are optional. |
| `ZENDESK_CREATE_TICKET_FIELD_OPTION` | Create Ticket Field Option | Create or update an option for a dropdown or multiselect ticket field. Use when you need to add a new selectable option to a custom ticket field of type 'multiselect' or 'tagger'. If an option with the same value already exists, it will be updated with the provided name. This action is idempotent - running it multiple times with the same value will update the existing option rather than creating duplicates. |
| `ZENDESK_CREATE_TRIGGER` | Create Trigger | Create a new trigger in Zendesk. Triggers are business rules that automatically perform actions on tickets when certain conditions are met. Unlike automations, triggers execute immediately when tickets are created or updated. Use this action when you need to: - Automatically change ticket status based on conditions - Assign tickets to agents or groups based on rules - Add tags to tickets matching certain criteria - Send notifications to agents, groups, or external systems - Update custom fields based on ticket properties Note: Triggers must have at least one condition in the 'all' array that references a time-based field (like created_at, updated_at) OR checks one of: status, type, group_id, assignee_id, requester_id, custom_status_id. |
| `ZENDESK_CREATE_TRIGGER_CATEGORIES_JOB` | Create Trigger Categories Batch Job | Create a batch job for ticket trigger categories in Zendesk. Use this action when you need to perform batch operations on multiple trigger categories at once. The action 'patch' allows updating trigger categories in bulk. Returns job status and results that can be polled for completion. Endpoint: POST /api/v2/trigger_categories/jobs |
| `ZENDESK_CREATE_TRIGGER_CATEGORY` | Create Zendesk Trigger Category | Create a new trigger category in Zendesk. Trigger categories are used to organize and group triggers for better management. Use when setting up automated workflows or organizing business rules. This action creates a trigger category with the specified name and optional position. The name must be unique within the account. |
| `ZENDESK_CREATE_USER_FIELD_OPTION` | Create User Field Option | Create or update an option for a dropdown or multiselect user field. Use when you need to add a new selectable option to a custom user field of type 'multiselect' or 'tagger'. If an option with the same value already exists, it will be updated with the provided name. This action is idempotent - running it multiple times with the same value will update the existing option rather than creating duplicates. |
| `ZENDESK_CREATE_USER_IDENTITY` | Create User Identity | Tool to add an identity to a user's profile in Zendesk. An agent can add multiple identities to a user (e.g., multiple email addresses). Use this when a user needs to be contacted via a new channel or needs an additional identifier. Use when you need to add an additional identity (email, phone, social) to an existing Zendesk user. |
| `ZENDESK_CREATE_USER_PROFILES_EVENTS` | Create User Profile Event | Store an event against a Sunshine user profile. Creates the profile if it doesn't exist. Use when tracking user activities such as purchases, sign-ups, or custom application events. The event is associated with the profile identified by the provided identifiers. This action is useful for building user activity timelines and triggering automations based on profile events. |
| `ZENDESK_CREATE_USERS_LOGOUT_MANY` | Logout Many Zendesk Users | Log out multiple users in Zendesk by ending their active sessions. This action is irreversible — the affected users will be logged out and will need to re-authenticate. Use when you need to immediately terminate sessions for multiple users (e.g., after security incident, offboarding, or credential revocation). The operation accepts up to 100 user IDs at a time. |
| `ZENDESK_CREATE_USERS_ORGANIZATION_MEMBERSHIPS` | Create User Organization Membership | Create a new organization membership for a specific user in Zendesk by assigning a user to an organization. Use when you need to associate an existing user with an organization so they can access organization-specific tickets and data. This action targets a specific user by their ID. This action is idempotent in that creating a duplicate membership will fail with a specific error, but the operation itself is not naturally idempotent. |
| `ZENDESK_CREATE_USERS_TAGS` | Create Users Tags | Set tags on a Zendesk user via POST request to /api/v2/users/{user_id}/tags. Use when you need to add or update tags on a specific user. Note that this replaces all existing tags on the user with the provided set of tags. This action is idempotent. |
| `ZENDESK_CREATE_VIEW` | Create View | Create a new view in Zendesk. Views are saved ticket filters that help agents organize and prioritize their work. They can filter tickets by conditions like status, priority, assignee, and more. Use this action when you need to: - Create a custom view for a specific team or workflow - Set up views for different ticket priorities or statuses - Create views with restricted access for specific groups - Configure views with specific columns, grouping, and sort order Note: At minimum, the 'all' conditions must include a condition checking 'status', 'type', 'group_id', 'assignee_id', or 'requester_id'. |
| `ZENDESK_CREATE_VIEWS_PREVIEW` | Preview View | Preview a Zendesk view by constructing conditions and execution settings to see which tickets match. Use when you need to test or validate view conditions before saving, or to retrieve a live preview of tickets matching specific filter criteria without creating a permanent view. This action is useful for verifying view logic, testing conditions, and previewing results before committing to a saved view. |
| `ZENDESK_CREATE_VIEWS_PREVIEW_COUNT` | Preview View Ticket Count | Preview ticket count for a view in Zendesk. Returns the number of tickets matching the specified conditions before saving the view. Use when you want to verify how many tickets will match a view's filter criteria before creating or updating a view. This action sends a POST request to /api/v2/views/preview/count with view conditions and returns the matching ticket count. Rate limited to 5 requests per minute, per view, per agent. |
| `ZENDESK_CREATE_ZENDESK_ATTACHMENTS` | Upload Zendesk Attachment | Upload a file attachment to Zendesk. Returns an attachment object with an ID that can be used to attach the file to a ticket comment. Use when you need to add files (documents, images, logs, etc.) to Zendesk tickets. The upload token returned is valid for 60 minutes. After uploading, attach the file to a ticket by including the attachment token in your ticket comment. |
| `ZENDESK_CREATE_ZENDESK_CUSTOM_OBJECT` | Create Zendesk Custom Object | Create a new custom object in Zendesk. Use when you need to define a new custom object type to store and manage custom data. The key is immutable once created, so choose carefully. |
| `ZENDESK_CREATE_ZENDESK_CUSTOM_OBJECT_FIELD` | Create Zendesk Custom Object Field | Create a new field for a custom object in Zendesk. Use when you need to add a new attribute or data field to an existing custom object type. The key is immutable once created. This action is idempotent for the same key, but the key parameter must be unique per custom object. |
| `ZENDESK_CREATE_ZENDESK_GROUP` | Create Zendesk Group | Create a new group in Zendesk. The group name must be unique within the account. Use when organizing agents into teams for ticket assignment and routing. Returns the full group object including the assigned ID — persist it for subsequent operations. |
| `ZENDESK_CREATE_ZENDESK_IMPORT_TICKET` | Import Zendesk Ticket | Import a ticket into Zendesk with historical timestamps. This action creates tickets with past `created_at`, `updated_at`, or `solved_at` values, useful for migrating historical data. For real-time ticket creation, use ZENDESK_CREATE_ZENDESK_TICKET. Tickets created with 'closed' status and archive_immediately=true bypass normal lifecycle and go directly to archive. |
| `ZENDESK_CREATE_ZENDESK_ORGANIZATION` | Create Zendesk Organization | Create a new organization in Zendesk. After creation, the organization ID is auto-assigned and returned. Verify the exact ID before performing downstream operations that target this organization. Multiple organizations may share similar names — always confirm the correct organization by ID. This action is irreversible — the organization cannot be recovered once deleted. Use this action when you need to register a new company, customer, or group as a Zendesk organization so you can assign users, tickets, or other resources to it. |
| `ZENDESK_CREATE_ZENDESK_REQUEST` | Create Zendesk Request | Create a new request in Zendesk. Use when an end user needs to submit a support request through the API. The request will be created with the provided subject, description, priority, and other optional fields. Returns the created request with its ID and URL. |
| `ZENDESK_CREATE_ZENDESK_TARGET` | Create Zendesk Target | Create a target in Zendesk for triggering outbound integrations. Use when you need to set up a notification channel or integration with external services like Campfire, email, URL webhooks, or other supported targets. Targets can be used with triggers and automation rules. Note: URL targets are being discontinued October 28, 2024 in favor of webhooks. Email targets remain unaffected. |
| `ZENDESK_CREATE_ZENDESK_TICKET` | Create Zendesk Ticket | Create a ticket in Zendesk with full support for all ticket fields. Returns `ticket_id` and `ticket_url`; use ZENDESK_GET_ZENDESK_TICKET_BY_ID for the full ticket object. |
| `ZENDESK_CREATE_ZENDESK_TICKET_OR_VOICEMAIL_TICKET` | Create Ticket or Voicemail Ticket | Create a ticket in Zendesk via the voice/channel API endpoint. Use this action when you need to create tickets from phone calls, voicemails, or other voice channel interactions. Returns `ticket_id` and `ticket_url` for the created ticket. This endpoint is specifically for Zendesk Talk/voice channel ticket creation. |
| `ZENDESK_CREATE_ZENDESK_USER` | Create Zendesk User | Tool to create a new user in Zendesk. Search for existing users first to avoid duplicate accounts with the same email. Use when you need to onboard a user with specific details. |
| `ZENDESK_CREATE_ZENDESK_USER_FIELD` | Create Zendesk User Field | Create a custom user field in Zendesk. Use when you need to define a new custom field to capture additional user data. Supports text, checkbox, dropdown, multiselect, date, integer, decimal, regexp validation, and lookup types. Only administrators can create user fields. |
| `ZENDESK_DELETE_ACCESS_RULE` | Delete Access Rule | Delete an access rule for a custom object in Zendesk. This action is irreversible — the access rule cannot be recovered once deleted. Use when you need to remove access control rules for custom objects. |
| `ZENDESK_DELETE_AUTOMATION` | Delete Zendesk Automation | Permanently deletes an automation in Zendesk. This action is irreversible — the automation will be permanently deleted and cannot be recovered once removed. Use when cleaning up obsolete automations or removing test data. **Note**: You might be restricted from deleting automations that are active or referenced by other rules. |
| `ZENDESK_DELETE_BUSINESS_HOURS_SCHEDULE` | Delete Zendesk Business Hours Schedule | Permanently deletes a business hours schedule in Zendesk. Use when you need to remove obsolete schedules or clean up test data. This action is irreversible — the schedule cannot be recovered once removed. Admin permissions are required. **Note**: Schedules that are currently in use by active SLA policies or other configurations may not be deletable. |
| `ZENDESK_DELETE_CUSTOM_OBJECT_RECORD_ATTACHMENT` | Delete Custom Object Record Attachment | Permanently deletes an attachment from a custom object record in Zendesk. Use this action when you need to remove a specific file attachment from a custom object record. This action is irreversible — the attachment will be permanently deleted and cannot be recovered once removed. **Note**: Only attachments that are not required and not the primary attachment can be deleted. |
| `ZENDESK_DELETE_CUSTOM_OBJECT_RECORD_BY_EXTERNAL_ID_OR_NAME` | Delete Custom Object Record | Permanently deletes a custom object record in Zendesk by its external ID or name. Use this action when you need to remove a specific record from a custom object. This action is irreversible — the record cannot be recovered once deleted. Requires admin permissions. **Note**: Either external_id or name must be provided to identify the record to delete. |
| `ZENDESK_DELETE_DELETED_TICKET` | Delete Deleted Ticket Permanently | Permanently deletes a soft-deleted ticket from Zendesk. This action is irreversible - once a ticket is permanently deleted, it cannot be recovered. Use this action to remove tickets that were previously soft-deleted using the delete_ticket action. Use this action when you need to permanently remove a ticket that has already been deleted and is no longer accessible through normal operations. |
| `ZENDESK_DELETE_DELETION_SCHEDULE` | Delete Zendesk Deletion Schedule | Permanently deletes a deletion schedule in Zendesk. This action is irreversible — the deletion schedule will be permanently deleted and cannot be recovered once removed. Use when cleaning up obsolete deletion schedules or removing test data. |
| `ZENDESK_DELETE_GROUP_MEMBERSHIP` | Delete Zendesk Group Membership | Permanently deletes a group membership in Zendesk, immediately removing a user from a group. This action is irreversible — the group membership cannot be recovered once deleted. Use when cleaning up obsolete group memberships or removing users from groups. **Note**: Deleting a group membership does not delete the user or the group itself, only the association between them. |
| `ZENDESK_DELETE_GROUP_MEMBERSHIPS_DESTROY_MANY` | Bulk Delete Zendesk Group Memberships | Bulk delete group memberships in Zendesk. Immediately removes users from groups. This action is irreversible — the memberships will be permanently deleted and cannot be recovered once removed. Use when cleaning up test data or removing obsolete group memberships in one call. Returns a job_status payload; deletions complete asynchronously. |
| `ZENDESK_DELETE_MACRO` | Delete Zendesk Macro | Permanently deletes a macro in Zendesk. This action is irreversible — the macro will be permanently deleted and cannot be recovered once removed. Use when cleaning up obsolete macros or removing test data. **Note**: You might be restricted from deleting macros that are active or referenced by other rules. |
| `ZENDESK_DELETE_MACROS_DESTROY_MANY` | Bulk Delete Zendesk Macros | Bulk delete macros in Zendesk. This action is irreversible — the macros will be permanently deleted and cannot be recovered once removed. Use when cleaning up obsolete macros or removing test data. |
| `ZENDESK_DELETE_MANY_AUTOMATIONS` | Bulk Delete Zendesk Automations | Bulk delete automations in Zendesk. This action is irreversible — the automations will be permanently deleted and cannot be recovered once removed. Use when cleaning up obsolete automations or removing test data. |
| `ZENDESK_DELETE_MANY_OBJECT_TRIGGERS` | Bulk Delete Zendesk Custom Object Triggers | Bulk delete triggers for a Zendesk custom object. This action is irreversible — the triggers will be permanently deleted and cannot be recovered once removed. Use when cleaning up obsolete triggers or removing test data for a specific custom object. Returns a success indicator upon completion. Requires the custom object key and a comma-separated list of trigger IDs to identify which triggers to delete. |
| `ZENDESK_DELETE_MANY_ORGANIZATION_MEMBERSHIPS` | Bulk Delete Zendesk Organization Memberships | Bulk delete organization memberships in Zendesk. This action is irreversible — the memberships will be permanently removed and cannot be recovered once deleted. Use when cleaning up obsolete organization memberships or removing users from organizations. Returns a job_status payload (initial status typically 'queued'); deletions complete asynchronously and may require follow-up polling to confirm completion. |
| `ZENDESK_DELETE_MANY_VIEWS` | Bulk Delete Zendesk Views | Bulk delete views in Zendesk. This action is irreversible — the views will be permanently deleted and cannot be recovered once removed. Use when cleaning up obsolete views or removing test data. Returns 204 No Content on success. |
| `ZENDESK_DELETE_ORGANIZATION_FIELD` | Delete Zendesk Organization Field | Permanently deletes an organization field in Zendesk. Use this action when you need to remove a custom organization field from the system. This action is irreversible — the organization field will be permanently deleted and cannot be recovered once removed. Any data stored in this field across all organizations will be lost. **Note**: Ensure no organizations are using this field before deletion, as the deletion cannot be undone. |
| `ZENDESK_DELETE_ORGANIZATION_MEMBERSHIP` | Delete Organization Membership | Permanently removes a user from an organization in Zendesk by deleting the organization membership. This action is irreversible — the membership cannot be recovered once deleted. Use this action when you need to remove a user's association with an organization. This operation requires admin permissions. |
| `ZENDESK_DELETE_ORGANIZATIONS_TAGS` | Delete Organization Tags | Remove all tags from a Zendesk organization. Use when you need to clear organization tags as part of cleanup or reorganization tasks. This action is irreversible — the tags will be permanently removed from the organization and cannot be recovered once deleted. |
| `ZENDESK_DELETE_ORGANIZATION_SUBSCRIPTION` | Delete Zendesk Organization Subscription | Permanently deletes an organization subscription in Zendesk. This action is irreversible — the subscription cannot be recovered once removed. Use when you need to remove an organization subscription. |
| `ZENDESK_DELETE_RESOURCE_COLLECTIONS` | Delete Resource Collection | Delete a resource collection in Zendesk. Use when you need to remove a resource collection that is no longer needed. This action returns a job status that can be polled to track the deletion progress. This operation is irreversible; confirm the correct resource_collection_id before executing. |
| `ZENDESK_DELETE_SUSPENDED_TICKETS_DESTROY_MANY` | Bulk Delete Zendesk Suspended Tickets | Permanently deletes multiple suspended tickets in Zendesk. This action is irreversible — the suspended tickets will be permanently deleted and cannot be recovered once removed. Use when cleaning up spam or irrelevant suspended tickets. Accepts up to 100 ticket IDs per request. |
| `ZENDESK_DELETE_TARGET` | Delete Zendesk Target | Permanently deletes a target in Zendesk. This action is irreversible — the target will be permanently deleted and cannot be recovered once removed. Use when cleaning up obsolete targets or removing test data. **Note**: Deleting a target that is actively used by triggers or other automation rules may cause those rules to fail. |
| `ZENDESK_DELETE_TICKET_FIELD` | Delete Zendesk Ticket Field | Permanently deletes a ticket field in Zendesk. Use this action when you need to remove a custom ticket field that is no longer needed. This action is irreversible — the ticket field and all associated data will be permanently deleted and cannot be recovered once removed. Requires admin permissions. **Note**: System ticket fields cannot be deleted. Only custom ticket fields can be removed. |
| `ZENDESK_DELETE_TICKET_FIELD_OPTION` | Delete Ticket Field Option | Permanently deletes an option from a ticket field in Zendesk. Use this action when you need to remove a specific selectable option from a dropdown or multiselect ticket field. This action is irreversible — the ticket field option will be permanently deleted and cannot be recovered once removed. **Note**: Only custom options can be deleted. System-defined options cannot be removed. |
| `ZENDESK_DELETE_TICKETS_TAGS` | Delete Ticket Tags | Remove tags from a Zendesk ticket. This action is irreversible; once tags are removed, they cannot be recovered without re-adding them. Use when you need to clean up ticket tags, remove outdated labels, or clear all tags from a ticket. |
| `ZENDESK_DELETE_TRIGGER` | Delete Zendesk Trigger | Permanently deletes a trigger in Zendesk. This action is irreversible — the trigger will be permanently deleted and cannot be recovered once removed. Use when cleaning up obsolete triggers or removing test data. **Note**: You might be restricted from deleting triggers that are active or referenced by other rules. |
| `ZENDESK_DELETE_TRIGGER_CATEGORY` | Delete Zendesk Trigger Category | Permanently deletes a trigger category in Zendesk. This action is irreversible — the trigger category will be permanently deleted and cannot be recovered once removed. Use when cleaning up obsolete trigger categories or removing test data. **Note**: You might be restricted from deleting trigger categories that are in use by active triggers. |
| `ZENDESK_DELETE_USER_FIELD` | Delete Zendesk User Field | Permanently deletes a user field in Zendesk, removing it from all user profiles. This action is irreversible — the field and all its associated data will be permanently lost. Use when cleaning up deprecated custom fields or removing test fields. |
| `ZENDESK_DELETE_USER_FIELD_OPTION` | Delete User Field Option | Permanently deletes an option from a user field in Zendesk. Use this action when you need to remove a specific selectable option from a dropdown or multiselect user field. This action is irreversible — the user field option will be permanently deleted and cannot be recovered once removed. |
| `ZENDESK_DELETE_USER_PERMANENTLY` | Permanently Delete User | Permanently deletes a soft-deleted user from Zendesk. This action is irreversible - once a user is permanently deleted, it cannot be recovered. Use this action to remove users that were previously soft-deleted using the delete_user action. Use this action when you need to permanently remove a user that has already been deleted and is no longer accessible through normal operations. This action requires appropriate admin permissions. |
| `ZENDESK_DELETE_USER_PROFILE` | Delete Zendesk User Profile | Permanently deletes a user profile in Zendesk by its profile ID. This action is irreversible — the profile and all associated data will be permanently lost. Use when cleaning up duplicate profiles, test profiles, or removing profiles that are no longer needed. Requires agent-level access with appropriate role permissions. |
| `ZENDESK_DELETE_USERS_DESTROY_MANY` | Bulk Delete Zendesk Users | Bulk delete users from Zendesk by their IDs or external IDs. This action is irreversible — once deleted, users cannot be recovered. Use when cleaning up test data, removing obsolete accounts, or consolidating user records in bulk. The operation returns a job_status payload (initial status typically 'queued'); deletions complete asynchronously and may require follow-up polling via the job_status URL to confirm completion. |
| `ZENDESK_DELETE_USER_SESSION` | Delete Zendesk User Session | Delete a specific user session in Zendesk. Use this action when you need to invalidate and remove a specific user session. This action is irreversible — the session cannot be recovered once deleted. Use when you need to forcibly log out a user or remove a specific session from their account for security or administrative purposes. |
| `ZENDESK_DELETE_USERS_GROUP_MEMBERSHIPS` | Delete Zendesk User's Group Membership | Permanently deletes a user's group membership in Zendesk, immediately removing a user from a group. This action is irreversible — the group membership cannot be recovered once deleted. Use when cleaning up obsolete group memberships, removing users from groups, or revoking group access. **Note**: Deleting a group membership does not delete the user or the group itself, only the association between them. The user will no longer have access to tickets routed to that group. |
| `ZENDESK_DELETE_USERS_IDENTITY` | Delete User Identity | Deletes an identity for a given user in Zendesk. Use when you need to remove a specific identity (e.g., email, phone, social login) from a user's account. This action is irreversible — once the identity is deleted, it cannot be recovered. Ensure you have the correct user_id and user_identity_id before executing. |
| `ZENDESK_DELETE_USERS_ME_LOGOUT` | Delete Authenticated Session | Delete the current authenticated session in Zendesk. This action invalidates the current API session, requiring re-authentication for future API calls. Use when you need to explicitly log out the current user session or terminate an active authenticated connection. This action is irreversible — the session cannot be recovered once deleted. Note: This action targets the authenticated user's own session only and cannot terminate other user sessions. |
| `ZENDESK_DELETE_USERS_ORGANIZATION_MEMBERSHIPS` | Delete User's Organization Membership | Permanently removes a user from an organization in Zendesk by deleting the organization membership for a specific user. This action is irreversible — the membership cannot be recovered once deleted. Use this action when you need to remove a user's association with an organization for a specific user. This operation requires admin permissions. |
| `ZENDESK_DELETE_USERS_SESSIONS` | Delete All User Sessions | Bulk delete all sessions for a specific user in Zendesk. This action invalidates all active sessions for the specified user, forcing them to re-authenticate on their next API call or login. Use when you need to forcibly log out a user by revoking all their active sessions, such as during security incidents or account deactivation. This action is irreversible — all sessions for the user will be immediately invalidated and cannot be recovered. |
| `ZENDESK_DELETE_USERS_TAGS` | Delete User Tags | Remove tags from a Zendesk user. Use when you need to clean up user tags, remove outdated labels, or clear all tags from a user account. This action is irreversible — once tags are removed, they cannot be recovered without re-adding them. |
| `ZENDESK_DELETE_VIEW` | Delete Zendesk View | Delete a single view in Zendesk. This action is irreversible — the view will be permanently deleted and cannot be recovered once removed. Use when you need to remove a specific obsolete view or test view. Returns 204 No Content on success. |
| `ZENDESK_DELETE_ZENDESK_APP_INSTALLATION` | Delete Zendesk App Installation | Permanently removes an installed app from Zendesk. Use when you need to uninstall an app from your Zendesk instance. This action is irreversible — the app installation cannot be recovered once removed. Admin permissions are required. |
| `ZENDESK_DELETE_ZENDESK_BOOKMARK` | Delete Zendesk Bookmark | Permanently deletes a bookmark in Zendesk. Use when you need to remove a user bookmark. This action is irreversible — the bookmark cannot be recovered once deleted. |
| `ZENDESK_DELETE_ZENDESK_CUSTOM_OBJECT` | Delete Zendesk Custom Object | Permanently deletes a custom object definition in Zendesk. Use this action when you need to remove a custom object type and all its associated records. This action is irreversible — the custom object and all its data will be permanently deleted and cannot be recovered once removed. Requires admin permissions. **Note**: Deleting a custom object will also delete all records associated with it. |
| `ZENDESK_DELETE_ZENDESK_CUSTOM_OBJECT_FIELD` | Delete Zendesk Custom Object Field | Permanently deletes a custom object field in Zendesk. Use this action when you need to remove a specific field from a custom object definition. This action is irreversible — the field and all its data will be permanently deleted and cannot be recovered once removed. Requires admin permissions. |
| `ZENDESK_DELETE_ZENDESK_CUSTOM_OBJECT_RECORD` | Delete Zendesk Custom Object Record | Permanently deletes a custom object record in Zendesk. Use this action when you need to remove a specific record from a custom object type. This action is irreversible — the record and its data will be permanently deleted and cannot be recovered once removed. Requires the custom object key and the record ID to identify which specific record to delete. |
| `ZENDESK_DELETE_ZENDESK_CUSTOM_STATUS` | Delete Zendesk Custom Status | Permanently deletes a custom ticket status in Zendesk. Use this action when you need to remove a custom ticket status from the system. This action is irreversible — the custom status will be permanently deleted and cannot be recovered once removed. **Note**: Ensure no tickets are using this custom status before deletion. |
| `ZENDESK_DELETE_ZENDESK_DYNAMIC_CONTENT_ITEM` | Delete Zendesk Dynamic Content Item | Permanently deletes a dynamic content item in Zendesk. This action is irreversible — the dynamic content item cannot be recovered once deleted. Always confirm the correct dynamic_content_item_id before executing. |
| `ZENDESK_DELETE_ZENDESK_DYNAMIC_CONTENT_ITEM_VARIANT` | Delete Zendesk Dynamic Content Item Variant | Permanently deletes a dynamic content item variant in Zendesk. This action is irreversible — the variant cannot be recovered once deleted. Always confirm the correct dynamic_content_item_id and dynamic_content_variant_id before executing. |
| `ZENDESK_DELETE_ZENDESK_OBJECT_TRIGGER` | Delete Zendesk Custom Object Trigger | Permanently deletes a custom object trigger in Zendesk. Use this action when you need to remove a specific trigger from a custom object definition. This action is irreversible — the trigger and all its data will be permanently deleted and cannot be recovered once removed. Requires admin permissions. |
| `ZENDESK_DELETE_ZENDESK_ORGANIZATION` | Delete Zendesk Organization | Delete an organization in Zendesk. This operation is irreversible; confirm organization_id and get explicit user confirmation before calling. |
| `ZENDESK_DELETE_ZENDESK_SUPPORT_ADDRESS` | Delete Zendesk Support Address | Permanently deletes a support address from Zendesk. This action is irreversible — the support address cannot be recovered once deleted. Use this action when you need to remove a deprecated or unwanted support email address from your Zendesk account. This operation requires admin permissions and the support address must not be set as the default address. Deleting an address that is actively used may impact email routing. |
| `ZENDESK_DELETE_ZENDESK_TICKET` | Delete Zendesk Ticket | Permanently deletes a ticket in Zendesk, including its entire conversation history. This action is irreversible; always confirm the correct ticket_id before executing. |
| `ZENDESK_DELETE_ZENDESK_USER` | Delete Zendesk User | Tool to permanently delete a user from Zendesk. Use when you need to remove a user account. This action cannot be undone and requires appropriate admin permissions. |
| `ZENDESK_DESTROY_MANY_DELETED_TICKETS` | Bulk Delete Soft-Deleted Zendesk Tickets | Permanently deletes multiple soft-deleted tickets in Zendesk. This action is irreversible — the tickets will be permanently removed and cannot be recovered once executed. Use when cleaning up test tickets or removing obsolete soft-deleted tickets in bulk. The operation returns a job_status payload (initial status typically 'queued'); deletions complete asynchronously and may require follow-up polling to confirm completion. Maximum 100 tickets per request. |
| `ZENDESK_DESTROY_MANY_ORGANIZATIONS` | Bulk Delete Zendesk Organizations | Bulk delete Zendesk organizations. This action is irreversible - once organizations are deleted, they cannot be recovered. Use when you need to remove multiple organizations in a single operation. Returns a job_status payload (initial status typically 'queued'); deletions complete asynchronously and may require follow-up polling to confirm completion. Maximum 100 organizations per request. Use this action when you need to clean up test data, remove obsolete organizations, or perform bulk organization deletions. You must provide either 'ids' (comma-separated list of Zendesk organization IDs) or 'external_ids' (comma-separated list of external IDs). |
| `ZENDESK_DETECT_BEST_LOCALE` | Detect Best Locale | Detect the best language/locale for the current user based on their browser settings and account preferences. Use when you need to determine the optimal language to display content in for a user, such as when localizing ticket comments, article content, or Help Center pages. This action reads the user's preferred languages from the Accept-Language header and matches them against supported locales in your Zendesk account. The detected locale is returned with full locale details including ID, name, and API URL. |
| `ZENDESK_DOWNLOAD_CUSTOM_OBJECT_RECORD_ATTACHMENT` | Download Custom Object Record Attachment | Download attachment file from a Zendesk custom object record. Use when you need to retrieve the actual file content of an attachment associated with a custom object record, such as documents, images, or other files. This action returns the raw file content and can display it inline or trigger a file download depending on the inline parameter. Note: The custom object must have attachments enabled for this action to work. |
| `ZENDESK_GET_ABOUT_ME` | Get Zendesk About Me | Get information about the currently authenticated user in Zendesk. Returns only the caller's own account; to look up other users, use ZENDESK_SEARCH_ZENDESK_USERS. Response nests the user object under data.owner_info.user. Useful for verifying the acting user's identity and permissions before performing bulk operations. |
| `ZENDESK_GET_ACCOUNT_SETTINGS` | Get Account Settings | Retrieve Zendesk account settings. Use this action when you need to view the configuration and feature flags for a Zendesk account, including API settings, branding, ticket preferences, chat configuration, voice settings, and more. |
| `ZENDESK_GET_ACTIVE_TRIGGERS` | List Active Triggers | List all active ticket triggers in Zendesk. Use when you need to retrieve the currently active trigger rules that automatically perform actions on tickets when certain conditions are met. This action returns all triggers marked as active, including their conditions, actions, and metadata. Active triggers are business rules that define what happens when ticket conditions are satisfied. This is useful for auditing active automation rules, understanding automated workflows, or finding specific trigger configurations. |
| `ZENDESK_GET_ACTIVITIES_COUNT` | Count Activities | Count ticket activities in Zendesk. Returns an approximate count of ticket activities. Use when you need to know how many activities exist in the activity stream for reporting or operational purposes. |
| `ZENDESK_GET_ALL_ZENDESK_ORGANIZATIONS` | Get Zendesk Organizations | Get all organizations in Zendesk. Returns results nested under an 'organizations' array; an empty list is valid. Accepts no server-side filters — all filtering by name, domain_names (an array field), or organization_fields must be done client-side. Large accounts require pagination; missing pages will undercount results. Multiple organizations may share similar names or domains — always disambiguate using external_id or domain_names and confirm organization_id before acting. Avoid repeated full-list fetches on large accounts; cache or batch client-side instead. |
| `ZENDESK_GET_APP` | Get App | Get a single Zendesk app by its numeric ID. Use when you have an app ID and need to retrieve the app's details including name, author information, version, installation count, categories, and description. |
| `ZENDESK_GET_APPS_INSTALLATIONS_REQUIREMENTS` | Get App Installation Requirements | List all requirements for a Zendesk app installation. Use when you need to check what configuration or parameters are required for a specific installed app to function properly. Requirements may include OAuth settings, parameter configurations, or other setup steps needed by the app. This action is read-only and idempotent. |
| `ZENDESK_GET_APPS_LOCATION` | Get App Location | Get details for a specific Zendesk app location by its numeric ID. Returns location properties including visibility settings, orderability, and associated product codes. Use when you have an app_location_id from listing locations or creating apps and need to retrieve detailed location information. Only accessible to admin users. |
| `ZENDESK_GET_APPS_LOCATION_INSTALLATIONS` | List Apps Location Installations | List all apps location installations from Zendesk. Returns an array of app installation IDs organized by location name. Use when you need to retrieve information about apps installed in specific locations within Zendesk, such as nav_bar or other supported locations. This action is read-only and idempotent. Allowed for: Admins only. |
| `ZENDESK_GET_APPS_PUBLIC_KEY` | Get App Public Key | Retrieves the public key for a specific Zendesk app. The response is in JSON Web Key (JWK) format containing RSA key components (modulus n, exponent e). Use this action when you need to verify JWTs issued by a Zendesk app or establish trust for app-based authentication. This is a read-only operation. |
| `ZENDESK_GET_APPS_PUBLIC_KEY_PEM` | Get App Public Key PEM | Retrieves the public key for a specific Zendesk app in PEM format. The PEM format is a standard base64-encoded certificate format that can be used to verify that requests from the app are legitimate. Use this action when you need to verify JWTs issued by a Zendesk app or establish trust for app-based authentication. This is a read-only operation. Note: This endpoint does not require authentication and can be accessed anonymously. |
| `ZENDESK_GET_ATTACHMENT` | Get Attachment | Retrieve details of a single Zendesk attachment by its ID. Use when you have an attachment_id from ticket comments or an attachments list and need to fetch full attachment metadata including file name, size, content type, URLs, and thumbnails. The action returns the attachment object with all available properties. |
| `ZENDESK_GET_AUTOCOMPLETE_TAGS` | Get Autocomplete Tags | Search for Zendesk tags using autocomplete. Use when you need to find tag suggestions based on a partial tag name for tagging tickets or organizing content. |
| `ZENDESK_GET_AUTOMATION` | Show Automation | Show a specific automation by its ID. Use when you need to retrieve details of a single automation rule in your Zendesk account, such as for auditing, modifying, or understanding what actions and conditions are configured for a particular automation. This action is read-only and idempotent. |
| `ZENDESK_GET_AUTOMATIONS` | List Automations | List all automations for the current Zendesk account. Use when you need to retrieve, audit, or review the automation rules configured in your Zendesk account. Automations are business rules that automatically perform actions based on trigger conditions. Supports both traditional offset pagination and cursor-based pagination. Filter by active status to show only enabled or disabled automations. |
| `ZENDESK_GET_AUTOMATIONS_SEARCH` | Search Automations | Search for Zendesk automations by their title. Use when you need to find automations in your Zendesk account by searching for keywords in their titles. Automations are business rules that automatically perform actions when certain conditions are met. This action supports filtering by active status and sorting results. |
| `ZENDESK_GET_BRANDS` | List Brands | List all brands configured in your Zendesk account. Use when you need to enumerate available brands, check which brand is set as default, or retrieve brand metadata like subdomain and host mappings. This is a read-only, idempotent operation that supports both cursor and offset pagination. |
| `ZENDESK_GET_BRANDS2` | Get Zendesk Brand | Show a Brand. Use when you have a brand ID and need to retrieve detailed information about a specific Zendesk brand, including its name, subdomain, active status, Help Center configuration, logo, and associated ticket forms. |
| `ZENDESK_GET_BRANDS_AGENTS` | List Agents by Brand | List agents assigned to a specific brand in Zendesk. Use when you need to enumerate which agents have access to a specific brand, such as auditing brand access permissions or determining which agents can access a brand's help center. This is a read-only, idempotent operation. |
| `ZENDESK_GET_CUSTOM_OBJECT_FIELDS_LIMIT` | Get Custom Object Fields Limit | Get the current count and maximum limit for custom object fields in Zendesk. Returns the number of fields currently defined for a specific custom object and the maximum allowed limit. Use when you need to check how many fields have been created for a custom object and how much capacity remains before hitting the limit. This is a read-only operation that does not modify any data. |
| `ZENDESK_GET_CUSTOM_OBJECT_RECORDS_LIMIT` | Get Custom Object Records Limit | Get the current record limit and usage count for custom objects in Zendesk. Returns the current number of custom object records and the maximum allowed limit. Use when you need to check how many custom object records have been created and how much capacity remains. This is a read-only operation that does not modify any data. |
| `ZENDESK_GET_CUSTOM_OBJECTS_LIMIT` | Get Custom Objects Limit | Get the current count and maximum limit for custom objects in Zendesk. Use when you need to check how many custom objects exist in your Zendesk account and what the allowed limit is, to avoid exceeding capacity or to plan for scaling. |
| `ZENDESK_GET_CUSTOM_STATUS` | Get Custom Status | Get a specific custom ticket status from Zendesk by its ID. Use when you have a custom status ID from ticket payloads or from listing custom statuses and need to retrieve the full status details including agent/end-user labels, descriptions, and status category. This is a read-only, idempotent operation that retrieves the current state of a custom ticket status. |
| `ZENDESK_GET_CUSTOM_STATUSES` | List Custom Ticket Statuses | List custom ticket statuses available in a Zendesk account. Use when you need to retrieve all undeleted custom ticket statuses, optionally filtered by status category, active state, or default status. This action is useful for understanding available custom statuses for ticket workflows, automation rules, or displaying status options to users. |
| `ZENDESK_GET_DELETED_TICKETS` | List Deleted Tickets | Lists tickets that have been deleted from Zendesk, showing up to 100 deleted tickets per page with pagination. Use when you need to retrieve information about previously deleted tickets or audit ticket deletions. This action is read-only and idempotent. |
| `ZENDESK_GET_DELETED_USER` | Get Deleted User | Retrieves a single deleted Zendesk user by their ID. Use when you have a specific deleted user ID and need to fetch details about that deleted user, such as for auditing purposes, account recovery, or compliance records. Deleted users retain their associated tickets and historical data. |
| `ZENDESK_GET_DELETION_SCHEDULE` | Get Deletion Schedule | Retrieve a specific deletion schedule from Zendesk by its ID. Use this action when you need to get the details of a particular deletion schedule, including its title, description, active status, object type, conditions, and creation/update timestamps. This action is read-only and idempotent. |
| `ZENDESK_GET_DELETION_SCHEDULES` | List Deletion Schedules | List all deletion schedules for the current Zendesk account. Use when you need to retrieve, audit, or review the deletion schedule rules configured in your Zendesk account. Deletion schedules define automated data retention policies that periodically remove specified entity types based on configured conditions. Only Zendesk admins can access this endpoint. |
| `ZENDESK_GET_DYNAMIC_CONTENT_ITEMS` | List Dynamic Content Items | List all dynamic content items configured in your Zendesk account. Use when you need to enumerate available dynamic content items, check variants for localization, or retrieve metadata about placeholder values for dynamic content. This is a read-only, idempotent operation that supports both cursor and offset pagination. |
| `ZENDESK_GET_DYNAMIC_CONTENT_ITEM_SHOW` | Show Dynamic Content Item | Show a specific dynamic content item by its ID. Use when you have a dynamic content item ID and need to retrieve its details, including name, default locale, placeholder value, variants, and creation/update timestamps. This is a read-only, idempotent operation that returns a single dynamic content item. |
| `ZENDESK_GET_DYNAMIC_CONTENT_ITEMS_SHOW_MANY` | Show Many Dynamic Content Items | Retrieve multiple dynamic content items by their identifiers. Use when you have specific dynamic content item IDs or names and need to fetch their metadata including placeholder, default locale, variants, and outdated status. This is a read-only, idempotent operation. The 'identifiers' parameter accepts comma-separated values; omit it to retrieve all items (use with caution on accounts with many items). |
| `ZENDESK_GET_DYNAMIC_CONTENT_ITEMS_VARIANTS` | List Dynamic Content Variants | List all variants of a specific Zendesk dynamic content item. Use when you need to retrieve all locale variants for a dynamic content item to view, manage, or update the localized content. Variants represent the same content in different locales/languages. Supports pagination and sorting parameters. This action is read-only and idempotent — calling it multiple times with the same parameters will return the same results without side effects. |
| `ZENDESK_GET_DYNAMIC_CONTENT_ITEM_VARIANT` | Show Dynamic Content Item Variant | Show a specific variant of a dynamic content item in Zendesk. Use when you have a dynamic_content_item_id and dynamic_content_variant_id and need to retrieve the variant's details including its content, locale, active status, and timestamps. This is a read-only operation. Dynamic content items allow you to create reusable content that can be localized into multiple variants for different languages or contexts. |
| `ZENDESK_GET_EMAIL_NOTIFICATION` | Get Email Notification | Retrieve details of a single email notification in Zendesk by its notification ID. Use when you have a notification_id from ticket audit logs or email notifications list and need to fetch full notification details including recipients, delivery status, and associated ticket/comment information. This action is useful for tracking email delivery status and troubleshooting email notification issues. |
| `ZENDESK_GET_EMAIL_NOTIFICATIONS` | Get Email Notifications | List email notifications from Zendesk. Use this action when you need to retrieve email notification records filtered by ticket, comment, or notification ID. The filter parameter is required to specify which type of ID to filter by. Returns delivery status information for each recipient including any delivery failures. |
| `ZENDESK_GET_EMAIL_NOTIFICATIONS_SHOW_MANY` | Show Many Email Notifications | Show details of many email notifications in Zendesk. Use when you need to retrieve multiple email notifications at once by their IDs, associated comment IDs, or associated ticket IDs. At least one of the filter parameters (ids, comment_ids, or ticket_ids) is required. |
| `ZENDESK_GET_END_USER_IDENTITIES` | List End User Identities | Tool to list all identities associated with a specific end user. Use when you need to retrieve the email addresses and/or phone numbers linked to an end user account. Supports optional filtering by identity type (email, phone_number). |
| `ZENDESK_GET_END_USER_IDENTITY` | Get End User Identity | Tool to fetch a specific end user identity by user ID and identity ID. Use when you need to retrieve detailed information about a particular user identity in Zendesk. |
| `ZENDESK_GET_GROUP_MEMBERSHIP` | Get Group Membership | Get a group membership by its unique ID. Use when you have a group membership ID and need to retrieve details including the associated group, user, and timestamps. Note: The group_membership_id parameter is the membership ID, not a group ID. |
| `ZENDESK_GET_GROUP_MEMBERSHIPS` | List Group Memberships | List all group memberships in your Zendesk account. Group memberships link users to groups, determining which agents belong to which support groups. Use when you need to audit group assignments, manage team memberships, or enumerate the relationship between users and groups. This action supports both offset pagination (page, per_page) and cursor pagination (page_size, page_after, page_before). It also supports sideloading related users and groups via the include parameter. This action is read-only and idempotent. |
| `ZENDESK_GET_GROUP_MEMBERSHIPS_BY_GROUP` | List Memberships By Group | List group memberships for a specific Zendesk group. Use when you need to retrieve all members assigned to a particular group, audit group membership, or understand which users belong to a specific support group. This action is read-only and idempotent. Supports both offset pagination (page, per_page) and cursor pagination (page_size, page_after, page_before). Also supports sideloading users and groups via the include parameter. |
| `ZENDESK_GET_GROUPS_ASSIGNABLE` | List Assignable Groups | List all groups that can be assigned to tickets or users in your Zendesk account. Use when you need to enumerate available groups for assignment operations, check group availability, or retrieve group metadata. This is a read-only, idempotent operation. |
| `ZENDESK_GET_GROUPS_COUNT` | Count Groups | Count groups in Zendesk. Returns an approximate count of groups in the system. Use when you need to know how many groups exist for reporting, organizational management, or operational purposes. This action is read-only and idempotent. |
| `ZENDESK_GET_GROUPS_USERS_COUNT` | Count Users by Group | Count users in a specific Zendesk group. Returns an approximate count of users belonging to the specified group, with optional filtering by role or permission set. Use when you need to know how many users are in a particular group for reporting, resource planning, or administrative purposes. This action is read-only and idempotent. |
| `ZENDESK_GET_GROUP_USERS` | List Group Users | List all users belonging to a specific Zendesk group. Use when you need to retrieve all members of a particular group, with optional filtering by user role, permission set, or external ID. This action is read-only and idempotent. |
| `ZENDESK_GET_GUIDE_SURVEY_RESPONSES` | List Guide Survey Responses | List survey responses from Zendesk Guide. Use when you need to retrieve CSAT survey responses, analyze customer satisfaction scores, or monitor survey completion rates. Survey responses are available on Support Professional plan and above, and Zendesk Suite Growth plan and above. This action is read-only and idempotent. |
| `ZENDESK_GET_GUIDE_SURVEYS` | List Guide Surveys | List available CSAT (Customer Satisfaction) surveys in Zendesk Guide. Use when you need to retrieve survey definitions, check which surveys are enabled/disabled, or get survey questions and versions. The response includes survey IDs, states, creation timestamps, and question arrays. This is a read-only, idempotent operation. |
| `ZENDESK_GET_INCREMENTAL_ORGANIZATIONS` | Get Incremental Organizations | Retrieve organizations that have been modified since a specified start time using the Incremental Organization Export API. Use when you need to sync or track changes to Zendesk organizations over time. Provide a start_time (Unix timestamp) from a previous response's end_time to paginate through changes incrementally. This action is read-only and idempotent. Organizations may be created, updated, or appear as deleted; interpret based on your use case. Rate limiting may apply for large accounts. |
| `ZENDESK_GET_INCREMENTAL_ROUTING_ATTRIBUTES` | Incremental Routing Attributes Export | Export routing attributes incrementally with optional start_time filtering and cursor-based pagination. Use when you need to retrieve all skill-based routing attributes (attributes, attribute values, and instance values) that have changed in your Zendesk account. This is a read-only operation that returns a stream of changes; it does not include data from the most recent minute. For large datasets, use cursor-based pagination with the after_cursor value from responses. This action is read-only and idempotent — calling it multiple times with the same start_time returns the same results. |
| `ZENDESK_GET_INCREMENTAL_ROUTING_ATTRIBUTE_VALUES` | Get Incremental Routing Attribute Values | Retrieve routing attribute values that have been modified since a specified start time using the Incremental Skill-Based Routing API. Use when you need to sync or track changes to routing attributes, values, and their associations over time. Provide a start_time (Unix timestamp) and the API returns all attribute values modified since that time. Call repeatedly with the end_time from each response to paginate through all changes. This action is read-only and idempotent. Note: Data isn't available for the most recent minute due to eventual consistency. Attribute values may appear as modified; interpret based on your use case. |
| `ZENDESK_GET_INCREMENTAL_ROUTING_INSTANCE_VALUES` | Export Incremental Routing Instance Values | Export incremental routing instance values from Zendesk skill-based routing. Returns a stream of changes that occurred on routing attributes, attribute values, and instance values. Use this action when you need to synchronize routing configuration data or monitor changes to skill-based routing assignments. This action is read-only and supports cursor-based pagination with a maximum of 3000 records per page. Stop paging when the count is 0. Note: The cursor parameter is read-only and should only be obtained from API responses, not manually constructed. |
| `ZENDESK_GET_INCREMENTAL_SAMPLE` | Get Incremental Sample Export | Test the incremental export by retrieving a sample of records that have changed since a specified start time. Use this action to verify your incremental export setup before running full exports. Use when you need to test the incremental export functionality for a specific resource type (e.g., tickets, users, organizations). The sample export returns a limited set of records that can help you validate data retrieval before implementing full sync operations. Note that data isn't provided for the most recent minute, and the start_time must be at least one minute in the past. |
| `ZENDESK_GET_INCREMENTAL_TICKET_EVENTS` | Get Incremental Ticket Events | Export incremental ticket events from Zendesk. Use when you need to track changes to tickets over time, monitor agent performance metrics, or sync ticket event data with an external system. This action returns a stream of ticket metric events (like agent work time, reply times) that occurred after the specified start_time. Call repeatedly with the end_time from each response to continue exporting events. Data isn't available for the most recent minute due to eventual consistency. Note: This is a read-only, idempotent operation. The start_time must be at least one minute in the past. |
| `ZENDESK_GET_INCREMENTAL_TICKET_METRIC_EVENTS` | List Ticket Metric Events | List ticket metric events in Zendesk that occurred on or after a specified time. This action supports incremental data export — use the end_time from one response as the start_time for the next request to retrieve subsequent events. This action is read-only and idempotent — use it to monitor ticket metrics, track SLA compliance, or build analytics dashboards. Note: deleted tickets can create orphan metric events; use exclude_deleted=true to filter these out. |
| `ZENDESK_GET_INCREMENTAL_TICKETS` | Get Incremental Tickets | Retrieve tickets that have been modified since a specified start time using the Incremental Ticket Export API. Use when you need to sync or track changes to Zendesk tickets over time, build audit trails, or implement incremental backups. Provide a start_time (Unix timestamp) from a previous response's end_time to paginate through changes incrementally. This action is read-only and idempotent. Tickets may be created, updated, or appear as changed; interpret based on your use case. Rate limiting may apply for large accounts. Note: Data isn't provided for the most recent minute. |
| `ZENDESK_GET_INCREMENTAL_TICKETS_CURSOR` | Get Incremental Tickets (Cursor) | Export tickets incrementally using cursor-based pagination. Use this action when you need to retrieve all changes to tickets since a specific time, with support for large result sets through cursor-based pagination. The start_time parameter is required for the initial request; subsequent pages use the cursor returned in previous responses. Use when you need to sync ticket data from Zendesk, maintaining a real-time or near-real-time copy of ticket information. This is ideal for data synchronization, backup systems, or analytics pipelines that need to process all ticket changes over time. The action automatically handles pagination by providing cursor tokens in the response. |
| `ZENDESK_GET_INCREMENTAL_USERS` | Get Incremental Users | Retrieve users that have been modified since a specified start time using the Incremental User Export API. Use when you need to sync or track changes to Zendesk users over time, such as for data warehousing, backup, or external system synchronization. Provide a start_time (Unix timestamp) and the API returns users that have been created, updated, or deleted since that time. Call repeatedly with the end_time from each response to paginate through all changes. This action is read-only and idempotent. Note: Data isn't available for the most recent minute due to eventual consistency. Users may appear as modified or deleted; interpret based on your use case. |
| `ZENDESK_GET_INCREMENTAL_USERS_CURSOR` | Incremental User Export (Cursor) | Export users incrementally using cursor-based pagination. Use when you need to export all users from Zendesk in a reliable, paginated manner. The start_time parameter is required for the initial request to define the time range. Subsequent requests use the cursor returned in previous responses to fetch the next batch of records. This action is ideal for: - Full user data synchronization to external systems - Regular incremental backups of user data - Building user directories with pagination support Note: Data from the most recent minute is not included to ensure consistency. |
| `ZENDESK_GET_JOB_STATUSES` | List Job Statuses | List job statuses from Zendesk. Shows the status of all background jobs that have been initiated, including those created by bulk operations like bulk updates, imports, or exports. Each job status includes progress information, completion status, and any results from individual tasks. Use this action to track the progress of long-running operations or check if background tasks completed successfully. Use this action when you need to check the status of background jobs, monitor bulk operation progress, or verify that asynchronous tasks have finished processing. |
| `ZENDESK_GET_JOB_STATUSES2` | Get Job Status | Get a single job status by ID from Zendesk. Shows the status of a background job initiated by bulk operations (like bulk updates, imports, or exports). The response includes progress information, completion status, and any results from individual tasks. Use this action when you have a job_status_id from a previously queued bulk operation and need to check if it completed successfully, failed, or is still processing. Check the 'status' field for the current state ('queued', 'working', 'completed', 'failed') and the 'results' array for individual task outcomes. |
| `ZENDESK_GET_LOCALE` | Get Locale | Get a locale by its ID or BCP-47 code. Use when you need to retrieve details about a specific locale including the locale identifier, language name, and timestamps. |
| `ZENDESK_GET_LOCALES` | List Locales | List all translation locales available for your Zendesk account. Use when you need to retrieve the available locales for translation purposes, check which languages are enabled, or get locale metadata including the locale code, display name, and creation timestamps. This is a read-only, idempotent operation that supports pagination. |
| `ZENDESK_GET_LOCALES_AGENT` | List Agent Locales | List the translation locales that have been localized for agent use. Use when you need to discover which locales are available for agents to work with in multilingual support scenarios. This is a read-only, idempotent operation that requires no parameters. |
| `ZENDESK_GET_LOCALES_CURRENT` | Get Current Locale | Show the current locale for a Zendesk account. Use when you need to determine what language/locale is currently active for the account, which affects how content is displayed to end users and which translations are available. |
| `ZENDESK_GET_MACRO2` | Show Macro | Show a specific macro by its ID. Use when you need to retrieve details of a single macro in your Zendesk account, such as for auditing, modifying, or understanding what actions and conditions are configured for a particular macro. Macros are saved response templates that agents can apply to tickets. Supports optional sideloads for usage statistics and additional metadata via the `include` parameter. |
| `ZENDESK_GET_MACRO_ATTACHMENTS` | List Macro Attachments | List all attachments associated with a specific Zendesk macro. Use when you need to retrieve the files attached to a macro, such as images used in macro content or documents included in automated responses. This is a read-only operation that returns the attachment metadata including filename, content type, size, and download URL. |
| `ZENDESK_GET_MACRO_CATEGORIES` | List Macro Categories | List all macro categories available to the current Zendesk account. Use when you need to retrieve or browse available macro categories for organizing and applying macros to tickets. This action is read-only and idempotent. |
| `ZENDESK_GET_MACRO_DEFINITIONS` | List Macro Action Definitions | Retrieve the definitions of all actions that a macro can perform in Zendesk. Use this action when you need to discover what actions are available for macro creation, understand the available values for each action type, or build a macro configuration interface. The response includes action fields, their display titles, types, and available value options. Common macro actions include: setting ticket status, priority, or type; assigning agents or groups; adding/removing tags; setting custom fields; and adding comments. |
| `ZENDESK_GET_MACRO_REPLICA` | Show Macro Replica | Show a macro replica (unpersisted macro representation) based on a macro ID and ticket ID. Use when you need to preview how a macro will look when applied to a specific ticket, allowing you to see the actions and values that will be applied without actually applying the macro. This is useful for testing macro configurations or displaying macro previews in your interface. This action is read-only and idempotent. |
| `ZENDESK_GET_MACROS` | List Macros | List all shared and personal macros available in your Zendesk account. Use when you need to retrieve, audit, or review the macros configured for automating ticket responses and actions. Macros are saved response templates that agents can apply to tickets. Supports filtering by access level, active status, category, and group. Results can be sorted by name, creation date, update date, or usage statistics. |
| `ZENDESK_GET_MACROS_ACTIONS` | List Macro Actions | List supported actions for macros in Zendesk. Use when you need to discover what field modifications are available when creating or editing macros. This endpoint returns the available action fields that can be set in a macro (e.g., status, priority, assignee, etc.) along with their possible values. This is useful for validating macro configurations or building macro management interfaces. This action is read-only and idempotent. |
| `ZENDESK_GET_MACROS_ACTIVE` | List Active Macros | List all active shared and personal macros in Zendesk. Use when you need to retrieve, audit, or review the macros configured in your Zendesk account. Macros are saved responses that agents can apply to tickets. This action supports filtering by access level, category, group, and sorting options. Note: This action only returns active macros. The sort_by parameter supports sorting by usage metrics (usage_1h, usage_24h, usage_7d, usage_30d) to identify the most frequently used macros. |
| `ZENDESK_GET_MACROS_APPLY` | Show Changes to Ticket | Show changes to a ticket that would result from applying a macro. Use when you need to preview what changes a macro would make to a ticket before actually applying it. This allows you to review the changes that would be applied, such as assignee changes, group reassignments, comments, or custom field updates. This action is read-only and idempotent — it does not actually modify the ticket. |
| `ZENDESK_GET_MACROS_SEARCH` | Search Macros | Search for Zendesk macros by their title. Use when you need to find macros in your Zendesk account by searching for keywords in their titles. Macros are pre-defined responses or actions that can be applied to tickets to automate repetitive tasks. This action supports filtering by access, active status, category, and group, as well as sorting results. |
| `ZENDESK_GET_OBJECT_TRIGGER` | Show Object Trigger | Show a specific trigger for a custom object in Zendesk. Use when you need to retrieve details of a single trigger, such as for auditing, understanding its conditions and actions, or preparing modifications. This action is read-only and idempotent. |
| `ZENDESK_GET_OPEN_REQUESTS` | List Open Requests | List open requests from Zendesk. Use this action when you need to retrieve all requests with "open" status for the authenticated user. Supports sorting by creation date or last update time. This action is read-only and idempotent. |
| `ZENDESK_GET_ORGANIZATION_FIELD2` | Get Organization Field | Get details for a specific organization field in Zendesk by its ID or key. Use this action when you need to retrieve detailed information about a single custom organization field, including its type, options, validation rules, and display settings. This is useful for understanding field configuration or before updating/deleting a field. Returns the complete organization field definition with all metadata. |
| `ZENDESK_GET_ORGANIZATION_FIELDS` | List Organization Fields | List all custom organization fields for the Zendesk account. Use this action when you need to retrieve or audit the custom organization field definitions configured in your Zendesk instance. Organization fields are used to store additional metadata about organizations beyond the standard attributes. Supports cursor-based pagination for retrieving large numbers of fields. Use resolve_dc=true to get resolved dynamic content placeholders instead of raw template strings. |
| `ZENDESK_GET_ORGANIZATION_MEMBERSHIP2` | Get Organization Membership | Get details for a specific organization membership by its ID. Use when you have an organization membership ID and need to retrieve the associated user, organization, and membership metadata. This action is read-only and idempotent - calling it multiple times with the same membership ID will return the same result. |
| `ZENDESK_GET_ORGANIZATION_RELATED` | Get Organization Related Info | Get related counts and information for a specific Zendesk organization by ID. Returns metadata about tickets, users, groups, activities, and other related resources associated with the organization. Use when you need to understand the scale and composition of an organization's resources in Zendesk. This is a read-only, idempotent operation. |
| `ZENDESK_GET_ORGANIZATION_REQUESTS` | List Organization Requests | List requests for a specific Zendesk organization. Use when you need to retrieve all requests associated with a particular organization. This action returns request details including subject, status, priority, requester, and timestamps. Pagination is available for large result sets. |
| `ZENDESK_GET_ORGANIZATIONS_AUTOCOMPLETE` | Autocomplete Organizations | Search for Zendesk organizations using autocomplete. Use when you need to find organization suggestions based on a partial organization name for ticket creation, user assignment, or organization lookup. The `name` parameter is required - provide at least a few characters for meaningful autocomplete results. Returns organizations sorted by relevance. |
| `ZENDESK_GET_ORGANIZATIONS_MERGES` | List Organization Merges | List all organization merge operations for a specific organization in Zendesk. This action retrieves the merge history showing which organizations were merged into or out of the specified organization. Use this action when you need to audit organization merge history or track the consolidation of organizations. Supports pagination to handle large result sets efficiently. This is a read-only, idempotent operation. |
| `ZENDESK_GET_ORGANIZATIONS_SHOW_MANY` | Show Many Organizations | Show many Zendesk organizations by their IDs or external IDs. Use when you need to retrieve multiple organizations in a single API call. Accepts up to 100 organization IDs or external IDs as comma-separated lists. Only one of ids or external_ids should be provided. Returns organization objects with all standard fields including name, domain_names, tags, and organization_fields. |
| `ZENDESK_GET_ORGANIZATIONS_TICKETS_COUNT` | Count Organization Tickets | Count organization tickets in Zendesk. Returns an approximate count of tickets for a specific organization. Use when you need to know how many tickets are associated with an organization for reporting or operational purposes. |
| `ZENDESK_GET_ORGANIZATION_SUBSCRIPTION` | Get Organization Subscription | Show Organization Subscription - retrieves details of a specific organization subscription by its ID. Use when you need to get information about an organization subscription, including the associated user and organization IDs, and the creation timestamp. This is a read-only operation that does not modify any data. |
| `ZENDESK_GET_ORGANIZATION_SUBSCRIPTIONS` | List Organization Subscriptions | List Organization Subscriptions in Zendesk. Returns organization subscriptions with pagination support (cursor and offset). Use when you need to retrieve all organization subscriptions or need to paginate through results. End users only see their own subscriptions. |
| `ZENDESK_GET_ORGANIZATION_TAGS` | Get Organization Tags | List all tags associated with a specific Zendesk organization. Use when you need to retrieve the tags assigned to a particular organization for ticket categorization, filtering, or reporting purposes. |
| `ZENDESK_GET_ORGANIZATION_TICKETS` | Get Organization Tickets | Get tickets for a specific organization in Zendesk. Returns tickets where organization_id matches the specified organization. Use when you need to retrieve all tickets associated with a particular organization, such as for reporting or review purposes. Pagination is available for large result sets; follow next_page links until null to retrieve all tickets. Note: This endpoint returns organization tickets that may include tickets from multiple requesters within the organization. |
| `ZENDESK_GET_ORGANIZATION_USERS` | List Organization Users | List all users associated with a specific Zendesk organization. Returns a paginated list of users who are members of the organization. Use when you need to see all users belonging to a particular organization, retrieve organization membership information, or audit organization access. Supports filtering by role, permission sets, and external IDs. Supports pagination via page number or cursor-based pagination. |
| `ZENDESK_GET_ORGANIZATION_USERS_COUNT` | Count Organization Users | Count users in a specific Zendesk organization by ID. Returns an approximate count of users. Use when you need to know how many users belong to a particular organization for reporting or operational purposes. |
| `ZENDESK_GET_OWNED_APPS` | Get Owned Apps | List apps owned by the current Zendesk account. Use when you need to retrieve information about apps installed in your Zendesk instance, such as checking installed apps, reviewing app details (version, status, author), or auditing your app inventory. This endpoint requires admin authentication. |
| `ZENDESK_GET_PROBLEMS` | List Ticket Problems | List Zendesk ticket problems. Use when you need to retrieve all tickets of type 'problem' in your Zendesk account. The response is always ordered by updated_at by default; use sort_by and sort_order parameters to customize. Supports both offset and cursor-based pagination. Note: Problems are tickets with type='problem'. This endpoint specifically returns problem-type tickets which are linked to other incidents that share the same root cause. |
| `ZENDESK_GET_PUBLIC_LOCALES` | List Public Locales | List all available public locales that can be used for translations in Zendesk. Use when you need to enumerate supported languages/locales for your Zendesk account, display language options to users, or determine which locales are available for ticket or article translations. This is a read-only, idempotent operation that returns the complete list of public locales with no pagination parameters. |
| `ZENDESK_GET_RECENT_TICKETS` | Get Recent Tickets | List recently viewed tickets in Zendesk. Returns tickets sorted by the time they were last viewed, most recent first. Useful for agents to quickly access tickets they've been working on. The endpoint returns tickets visible to the agent based on their permission restrictions. Pagination is limited to 10,000 records (100 pages * 100 per page). Use this action to retrieve the tickets an agent has recently accessed in the Zendesk interface. |
| `ZENDESK_GET_REMOTE_AUTHENTICATIONS` | List Remote Authentications | List all remote authentication configurations in your Zendesk account. Use this action when you need to enumerate SSO configurations, check which authentication methods are enabled, or retrieve metadata about remote authentication settings for agents and end users. This is a read-only, idempotent operation that returns all configured remote authentication providers including SAML, LDAP, JWT, and OAuth configurations. |
| `ZENDESK_GET_REQUEST_COMMENTS` | List Request Comments | List comments on a Zendesk request. Use when you need to retrieve all comments from a specific ticket request to understand the conversation history or gather context for responding. The comments are returned in chronological order. Each comment includes author information, content (both plain text and HTML formats), attachments, and metadata about how and when it was created. |
| `ZENDESK_GET_REQUESTS_CCDB` | List CCD Requests | List CCD Requests. Use when you need to retrieve requests where the authenticated end user is listed as a CC (carbon copy) recipient. These are requests the user is watching but did not create. Supports sorting by creation or update timestamps. |
| `ZENDESK_GET_REQUESTS_COMMENT` | Get Request Comment | Get a specific comment from a Zendesk request. Use when you need to retrieve a single comment by its ID for a given request, such as displaying a specific comment detail or checking comment metadata. This action is read-only and idempotent. |
| `ZENDESK_GET_REQUESTS_SEARCH` | Search Requests | Search for requests in Zendesk using query syntax. Use when you need to find customer requests across Zendesk using flexible search criteria such as status, priority, subject, or requester information. Returns paginated results with request details. This action is read-only and idempotent - searching for requests does not modify any data. |
| `ZENDESK_GET_REQUESTS_SOLVED` | List Solved Requests | List Zendesk requests with the 'solved' status. Useful for reviewing completed customer requests, generating reports on resolution times, or tracking customer satisfaction. Use this action when you need to retrieve requests that have been marked as solved. |
| `ZENDESK_GET_ROUTING_AGENTS_INSTANCE_VALUES` | Get Agent Attribute Values | Retrieve attribute values for multiple agents/users using the Skill-Based Routing API. Use when you need to get the routing attribute values (such as skills, languages, or other qualifications) assigned to specific agents. This action is read-only and idempotent. Note: This action returns only the attribute values directly assigned to the agents. It does not include inherited or group-based attributes. |
| `ZENDESK_GET_SATISFACTION_RATINGS` | List Satisfaction Ratings | List satisfaction ratings for tickets in Zendesk. Use when you need to retrieve customer satisfaction feedback, analyze CSAT scores, or review ratings with their associated tickets and assignees. Supports both offset and cursor pagination for large datasets. |
| `ZENDESK_GET_SATISFACTION_RATINGS_COUNT` | Count Satisfaction Ratings | Count satisfaction ratings in Zendesk. Returns an approximate count of satisfaction ratings. Use when you need to know how many satisfaction ratings exist for reporting or operational purposes. |
| `ZENDESK_GET_SEARCH_COUNT` | Get Search Results Count | Count the number of items matching a search query in Zendesk. Use when you need to know how many results a search would return without fetching all the actual results. This is useful for displaying result counts before executing a full search. |
| `ZENDESK_GET_SEARCH_EXPORT` | Export Search Results | Export search results from Zendesk using cursor-based pagination. Use when you need to export large sets of search results (tickets, users, organizations, groups) and process them in batches using cursor pagination. This action differs from the regular search endpoint by supporting cursor-based pagination instead of offset pagination, making it more efficient for large datasets. The 'page_after' parameter in responses contains the cursor token for fetching subsequent pages. |
| `ZENDESK_GET_SECURITY_SETTINGS` | Get Security Settings | Show Security Settings for a Zendesk account. Use when you need to retrieve the security configuration of a Zendesk account, including session timeouts, password policies, two-factor authentication settings, IP restrictions, and account assumption options. This is a read-only, idempotent operation that does not modify any data. This action is useful for auditing security settings, verifying compliance requirements, or understanding the security posture of a Zendesk account. |
| `ZENDESK_GET_SIDE_CONVERSATIONS_EVENTS` | List Side Conversation Events | Retrieve side conversation events for incremental export. Returns events created since the specified start_time in chronological order. Use when you need to export or sync side conversation events for backup, analytics, or integration purposes. This action supports pagination via the next_page URL which contains a next_start_time parameter — pass that timestamp as start_time for subsequent requests. Only available to Admins. Note: This is a read-only, idempotent action suitable for building event pipelines or audit trails. |
| `ZENDESK_GET_SUPPORT_ADDRESS` | Get Support Address | Get a support address by its unique ID. Use when you have a support_address_id and need to retrieve details including the email address, brand association, and DNS verification statuses. This is a read-only operation. |
| `ZENDESK_GET_TAGS` | List Tags | List Zendesk tags in order of popularity. Use when you need to view all available tags in your Zendesk account, or when you need to find tags that are most frequently used across tickets. |
| `ZENDESK_GET_TAGS_COUNT` | Count Tags | Count Tags in Zendesk. Returns an approximate count of tags. Use when you need to know how many tags exist in your Zendesk account for reporting or operational purposes. |
| `ZENDESK_GET_TARGET` | Show Target | Show a specific target by its ID. Use when you have a target ID and need to retrieve its details including title, type, active status, and creation timestamp. This is a read-only, idempotent operation that returns a single target object. This action is irreversible for data retrieval - it only reads target information, no destructive changes occur. |
| `ZENDESK_GET_TARGET_FAILURE` | Show Target Failure | Show a target failure in Zendesk. Use when you have a target_failure_id and need to retrieve details about a failed target execution, including the HTTP status code, raw request/response data, and consecutive failure count. This is a read-only operation. |
| `ZENDESK_GET_TARGET_FAILURES` | List Target Failures | List the 25 most recent target failures in Zendesk. Target failures occur when a target (webhook, callback, or external integration) fails to execute properly. Each failure record includes the request sent, response received, and status code. Use this action to monitor and troubleshoot failing integrations. |
| `ZENDESK_GET_TARGETS` | List Targets | List all targets for the current Zendesk account. Use when you need to retrieve, audit, or review the targets configured in your Zendesk account. Targets are endpoints that receive data when triggers or automations fire. This is a read-only, idempotent action with no required parameters. |
| `ZENDESK_GET_TICKET_AUDIT_BY_ID` | Get Ticket Audit | Show a specific audit for a ticket from Zendesk. Returns a single audit record containing events that describe changes made to the ticket. Each audit captures a specific action such as comments, status changes, assignments, or field updates. Use this action when you have a specific audit ID and want to retrieve detailed information about that audit event. Use this action when you need to retrieve detailed information about a specific audit record for a ticket, including all events and metadata associated with that audit. |
| `ZENDESK_GET_TICKET_COLLABORATORS` | List Ticket Collaborators | List all collaborators (CC'd users) on a Zendesk ticket. Use when you need to see who is currently CC'd on a ticket, such as when coordinating with multiple stakeholders or before adding/removing collaborators. Each collaborator is a user object with basic profile information. Paginate through results using page and per_page parameters. |
| `ZENDESK_GET_TICKET_COMMENTS` | Get Ticket Comments | List comments on a Zendesk ticket. Returns the comments added to the ticket in chronological order (oldest first by default). Each comment has both `html_body` and `plain_body` fields — use `plain_body` for clean text without HTML. Public comments are visible to end users while internal comments are only visible to agents. Use the `include_inline_images` parameter to include inline images as attachments. For bulk operations, honor `Retry-After` headers on HTTP 429 rate limit responses. |
| `ZENDESK_GET_TICKET_EMAIL_C_CS` | List Ticket Email CCs | List Email CCs for a Ticket. Use when you need to retrieve a list of users who are CC'd on a specific Zendesk ticket. This endpoint returns all email CC records associated with the ticket, including user details and timestamps. |
| `ZENDESK_GET_TICKET_FIELD2` | Show Ticket Field | Show a specific ticket field by its ID. Use when you need to retrieve details of a single ticket field in your Zendesk account, such as for auditing, understanding field configuration, or validating field properties. This action is read-only and idempotent. |
| `ZENDESK_GET_TICKET_FIELDS` | List Ticket Fields | List all system and custom ticket fields in Zendesk. Use when you need to retrieve field definitions for building forms, validating field values, or understanding available ticket field structure. Supports cursor-based pagination for large datasets. When creator=true is specified, includes creator_user_id and creator_app_name for each field. Locale parameter affects dynamic content variants for title_in_portal. |
| `ZENDESK_GET_TICKET_FIELDS_COUNT` | Count Ticket Fields | Count ticket fields in Zendesk. Returns an approximate count of system and custom ticket fields. Use when you need to know how many ticket fields exist for reporting or operational purposes. |
| `ZENDESK_GET_TICKET_FIELDS_SHOW_MANY` | Show Many Ticket Fields | Retrieve multiple ticket fields by their IDs or keys in a single request. Use when you have specific ticket field identifiers (numeric IDs like '123' or keys like 'priority', 'status', 'subject') and need to fetch their complete metadata including type, title, required status, custom options, and portal visibility settings. This is a read-only, idempotent operation. Up to 100 fields can be retrieved per request. Either `ids` or `keys` parameter can be used, but not both simultaneously. |
| `ZENDESK_GET_TICKET_FOLLOWERS` | List Ticket Followers | List all followers on a Zendesk ticket. Use when you need to see who is following a ticket, such as when coordinating with stakeholders or managing ticket notifications. Followers receive notifications about the ticket. Each follower is a user object with basic profile information. Paginate through results using page and per_page parameters. |
| `ZENDESK_GET_TICKET_FORMS` | List Ticket Forms | List all ticket forms configured in your Zendesk account. Use when you need to enumerate available ticket forms, retrieve form metadata like display names and visibility settings, or audit which ticket forms are active and visible to end users or agents. Supports filtering by active status, end-user visibility, form type (standard or service catalog), and brand association. Also supports both traditional offset pagination and cursor-based pagination. |
| `ZENDESK_GET_TICKET_FORMS_SHOW_MANY` | Show Many Ticket Forms | Show multiple ticket forms by their IDs. Use when you need to retrieve specific ticket forms by their IDs to display form details, validate form availability, or bulk fetch form configurations. The `ids` parameter accepts a comma-separated list of ticket form IDs (e.g., '1,2,3'). Returns an empty ticket_forms array for non-existent IDs without error. Supports optional filtering by active status, end-user visibility, brand association, and default form fallback behavior. |
| `ZENDESK_GET_TICKET_INCIDENTS` | List Ticket Incidents | List incidents linked to a problem ticket in Zendesk. Use when you need to retrieve all incident tickets that share the same root cause as a problem ticket. Incidents are tickets of type 'incident' that are related to a problem ticket via the problem_id field. Supports both offset and cursor-based pagination. |
| `ZENDESK_GET_TICKET_METRIC` | Get Ticket Metric | Retrieve a specific ticket metric from Zendesk by its ID. Use this action when you have a ticket_metric_id and need to fetch the detailed metrics for that ticket, including resolution times, wait times, reply times, and SLA breaches. This action is read-only and idempotent — fetching the same metric multiple times has no side effects. |
| `ZENDESK_GET_TICKET_METRICS` | Get Ticket Metrics | List Ticket Metrics from Zendesk. Returns a list of tickets with their associated metrics including response times, resolution times, and assignment statistics. Use when analyzing ticket performance, agent productivity, or customer satisfaction metrics. This action supports cursor-based pagination via page_size, page_after, and page_before parameters for efficient traversal of large datasets. |
| `ZENDESK_GET_TICKETS_AUDITS` | List Ticket Audits | List all audits (change history) for a specific Zendesk ticket. Use when you need to track all changes made to a ticket including comments, status changes, assignments, and other modifications. Each audit contains one or more events representing individual changes. This action is read-only and supports both traditional offset pagination and cursor-based pagination for large datasets. Audits are returned in chronological order by default. Note: This action retrieves the complete audit trail which is useful for compliance, troubleshooting, and understanding ticket evolution. |
| `ZENDESK_GET_TICKETS_AUDITS_COUNT` | Count Ticket Audits | Count audits for a specific ticket in Zendesk. Returns an approximate count of audits associated with the specified ticket. Use when you need to know how many audit records exist for a ticket for reporting, analytics, or operational purposes. |
| `ZENDESK_GET_TICKETS_COMMENTS_COUNT` | Count Ticket Comments | Count comments on a Zendesk ticket. Returns an approximate count of comments added to the specified ticket. Use when you need to know how many comments exist on a ticket without fetching the full comment list, such as for reporting or determining if pagination is needed. |
| `ZENDESK_GET_TICKETS_CONVERSATION_LOG` | Get Ticket Conversation Log | List conversation log events for a specific Zendesk ticket. Use this action when you need to retrieve the chronological history of interactions, comments, and activities on a ticket. The conversation log provides a comprehensive view of all events including comments, status changes, and other ticket activities. Supports cursor-based pagination for accessing large datasets. |
| `ZENDESK_GET_TICKETS_COUNT` | Count Zendesk Tickets | Count the number of tickets in Zendesk. Returns an approximate count of tickets with the timestamp of when the count was last calculated. This is a read-only, idempotent operation. Use when you need to know the total number of tickets for reporting, capacity planning, or operational purposes. Note that the count is approximate and may not reflect real-time changes. For detailed per-ticket information, use ZENDESK_LIST_ZENDESK_TICKETS instead. |
| `ZENDESK_GET_TICKET_SKIPS` | List Ticket Skips | List ticket skips for a specific ticket from Zendesk. Use when you need to retrieve all skip records associated with a particular ticket, such as when reviewing which agents skipped working on a ticket or analyzing skip patterns. This action is read-only and idempotent. It returns a list of skip records that include the reason for skipping, who skipped it, and when. |
| `ZENDESK_GET_TICKETS_METRICS` | Get Ticket Metrics | Get ticket metrics from Zendesk for a specific ticket. Returns performance metrics including resolution times, agent and requester wait times, reply counts, station changes, and timestamps for key events. Use when you need to analyze ticket performance, SLA compliance, or agent productivity metrics. |
| `ZENDESK_GET_TICKETS_SIDE_CONVERSATIONS_EVENTS` | List Side Conversation Events | List all events for a specific side conversation on a Zendesk ticket. Returns events in chronological order including creation, replies, and state updates. Use this action when you need to view the complete history of a side conversation including all messages and state changes. Side conversations are private agent-to-agent communications that don't appear in the main ticket thread. |
| `ZENDESK_GET_TRIGGER` | Show Trigger | Show a specific trigger by its ID. Use when you need to retrieve details of a single trigger in your Zendesk account, such as for auditing, modifying, or understanding what actions and conditions are configured for a particular trigger. This is useful for reviewing business rules before making changes or understanding automation behavior. This action is read-only and idempotent. |
| `ZENDESK_GET_TRIGGER_CATEGORIES` | List Trigger Categories | List all ticket trigger categories in your Zendesk account. Use when you need to retrieve, audit, or review the trigger category organization for your business rules and automations. Supports filtering with sort options (position, name, created_at, updated_at) and can include rule counts via the `include` parameter to show how many triggers are in each category. |
| `ZENDESK_GET_TRIGGER_CATEGORIES2` | Show Trigger Category | Show a specific ticket trigger category by its ID. Use when you need to retrieve details of a single trigger category, such as for auditing or understanding the organization of your ticket triggers. This action is read-only and idempotent. |
| `ZENDESK_GET_TRIGGERS` | List Ticket Triggers | List all ticket triggers for the current Zendesk account. Use when you need to retrieve, audit, or review the trigger rules configured in your Zendesk account. Triggers are business rules that automatically perform actions based on conditions when tickets are created or updated. Supports filtering by active status and category. Also supports both traditional offset pagination and cursor-based pagination for sorting. |
| `ZENDESK_GET_TRIGGERS_DEFINITIONS` | Get Ticket Trigger Definitions | Get Ticket Trigger Action and Condition Definitions. Use when you need to discover the available actions and conditions that can be used to create or configure ticket triggers. This returns metadata about what types of automations are possible - the action definitions show what a trigger can do (e.g., set status to 'solved'), while the condition definitions show what conditions can trigger it (e.g., when status is 'open'). This is a read-only, idempotent operation that returns the available trigger definitions metadata. |
| `ZENDESK_GET_TRIGGERS_SEARCH` | Search Ticket Triggers | Search for Zendesk ticket triggers by their title. Use when you need to find triggers in your Zendesk account by searching for keywords in their titles. Triggers are business rules that automatically perform actions when certain conditions are met on tickets. This action supports filtering by active status, sorting, and sideloading usage statistics. This is a read-only and idempotent action that queries existing triggers without making any changes. |
| `ZENDESK_GET_USER` | Get User | Tool to fetch a single Zendesk user by numeric user_id. Use when you have a user ID from ticket payloads (requester_id, submitter_id, assignee_id, author_id) and need to enrich with full user details (name, email, role, organization_id, etc.). |
| `ZENDESK_GET_USER_ENTITLEMENTS_FULL` | Get Full User Entitlements | Tool to retrieve full entitlements for a Zendesk user across all products (Chat, Explore, Talk, Guide). Use when you need to check which Zendesk products a user has access to and their activation status. Returns detailed entitlement information including whether each product is active and its display name. |
| `ZENDESK_GET_USER_EVENTS` | Get User Events | Retrieve event history for a specific Zendesk user. Use when you need to track user activity such as login history, profile changes, or other interactions with the Zendesk system. Supports filtering by event source, type, and time range. This action is read-only and idempotent. Note: The 'zendesk' source value is protected; attempts to use it when creating events result in an error. |
| `ZENDESK_GET_USER_FIELD_BY_ID` | Get User Field By ID | Retrieve a single Zendesk user field by its numeric ID. Use when you have a user field ID and need to fetch its full definition including title, type, description, custom options, validation patterns, and other settings. This is a read-only, idempotent operation. |
| `ZENDESK_GET_USER_FIELD_OPTIONS` | List User Field Options | List custom user field options for a given user field. Use when you need to retrieve the dropdown or tag options available for a custom user field in Zendesk. This action fetches the configurable options that can be selected for custom user fields of type dropdown, tagger, or similar multi-option field types. |
| `ZENDESK_GET_USER_FIELDS` | List User Fields | List all custom user fields configured in your Zendesk account. Use when you need to retrieve the schema of user-defined fields (like dropdown options, validation patterns, or field types) to build dynamic forms or validate field values. |
| `ZENDESK_GET_USER_FIELDS_SHOW_MANY` | Get User Fields Show Many | Retrieve multiple Zendesk user fields by their keys. Use when you have specific user field keys and need to fetch their definitions (title, type, description, options, etc.) in a single request instead of making individual calls. This is a read-only, idempotent operation. |
| `ZENDESK_GET_USER_PROFILES2` | Get User Profile by Profile ID | Retrieve a single Zendesk user profile by its Sunshine profile ID. Use this action when you have a specific profile_id (obtained from profile listings or search results) and need to fetch the full profile details including attributes, identifiers, and linked user information. Note that this uses the Sunshine Profiles API with string profile IDs, not numeric user IDs from the Users API. |
| `ZENDESK_GET_USER_PROFILES_EVENTS2` | Get User Profile Events by ID | Get events for a Sunshine profile by its profile ID. Use when you have a specific Sunshine profile ID (obtained from profile lookup or creation) and need to retrieve all events associated with that profile. This action is read-only and idempotent — use it to track profile activity, audit event history, or monitor user interactions for a specific profile. Note: The profile must exist or the request returns 404 Not Found. Use this action after creating or looking up a Sunshine profile to retrieve its event history. |
| `ZENDESK_GET_USERS_ASSIGNED_TICKETS` | Get User's Assigned Tickets | List tickets assigned to a specific Zendesk user. Returns all tickets where the specified user is the assignee. Use when you need to retrieve all tickets currently assigned to a particular agent or user, such as for workload analysis, ticket reassignment, or performance reporting. Pagination is available for large result sets; follow next_page links until null to retrieve all assigned tickets. Note: This endpoint only returns tickets assigned to the user, not tickets requested by or submitted by the user. |
| `ZENDESK_GET_USERS_AUTOCOMPLETE` | Autocomplete Users | Autocomplete users by name or phone number. Use when you need to find users based on a partial name or phone number for ticket creation or user lookup scenarios. At least one of 'name' or 'phone' must be provided. |
| `ZENDESK_GET_USERS_BRAND_AGENTS` | List Brand Agent Memberships By User | List brand agent memberships for a specific user in Zendesk. Use when you have a user ID and need to find all brands that the user is an agent for, such as auditing which brands a specific agent can access. This is a read-only, idempotent operation. |
| `ZENDESK_GET_USERS_CCD_TICKETS` | Get User's CC'd Tickets | List tickets where a specific Zendesk user is CC'd (carbon copied). Use when you need to retrieve all tickets where a particular user has been added as a CC recipient, such as for tracking user notifications, compliance monitoring, or ticket visibility analysis. Pagination is available for large result sets; follow next_page links until null to retrieve all CC'd tickets. Note: This endpoint only returns tickets where the user is a CC, not tickets requested by or assigned to the user. |
| `ZENDESK_GET_USERS_COMPLIANCE_DELETION_STATUSES` | Get User Compliance Deletion Statuses | Tool to fetch GDPR compliance deletion statuses for a specific Zendesk user. Use when you need to check the deletion status for each compliance area (e.g., chat, talk) associated with a user account. Returns status records showing deletion requests and their current state. Use when auditing user data deletion requests, verifying GDPR compliance status, or tracking the progress of data removal across different Zendesk products. |
| `ZENDESK_GET_USERS_COUNT` | Count Users | Count users in Zendesk. Returns an approximate count of users. If the count is more than 1000, the value is an estimate and the response is refreshed every 24 hours. Use when you need to know how many users exist in the system for reporting or administrative purposes. |
| `ZENDESK_GET_USER_SESSIONS` | List User Sessions | List all sessions for a specific Zendesk user. Returns details about each active session including authentication time and last seen time. Use this action to monitor session activity for a specific user, investigate security events, or audit login history for account troubleshooting. Use when you need to see all active sessions for a particular user, track their login activity, or investigate potential unauthorized access. |
| `ZENDESK_GET_USERS_FOLLOWED_TICKETS` | Get User's Followed Tickets | List tickets the specified Zendesk user is following. Returns all tickets where the specified user is a follower. Use when you need to retrieve all tickets a particular user is watching or tracking, such as for notification purposes, audit trails, or understanding which tickets a user has interest in. Pagination is available for large result sets; follow next_page links until null to retrieve all followed tickets. |
| `ZENDESK_GET_USERS_GROUP_MEMBERSHIPS` | List Memberships By User | List group memberships for a specific Zendesk user. Use when you need to retrieve all groups a user belongs to, audit user group assignments, or understand which support groups a specific user is a member of. This action is read-only and idempotent. Supports both offset pagination (page, per_page) and cursor pagination (page_size, page_after, page_before). Also supports sideloading users and groups via the include parameter. |
| `ZENDESK_GET_USERS_GROUP_MEMBERSHIPS_BY_ID` | Get User's Group Membership | Get a specific group membership for a user by their IDs. Use when you have both a user ID and a group membership ID and need to retrieve details including the associated group, user, and timestamps. This action retrieves a single group membership record scoped to a specific user, unlike GetGroupMembership which retrieves by membership ID alone, and unlike ListUsersGroupMemberships which lists all memberships for a user. |
| `ZENDESK_GET_USERS_GROUPS` | List User Groups | List all groups that a specific Zendesk user belongs to. Use when you need to find which support groups a user is a member of, audit team memberships, or retrieve group membership information for a particular user. This action supports both offset pagination (page as integer, per_page) and cursor pagination (page as object with size/after/before). It also supports excluding deleted groups and sorting results. This action is read-only and idempotent. |
| `ZENDESK_GET_USERS_GROUPS_COUNT` | Count User Groups | Count user groups in Zendesk. Returns an approximate count of groups that a specific user belongs to. Use when you need to know how many groups a user is assigned to for reporting, organizational management, or operational purposes. This action is read-only and idempotent. |
| `ZENDESK_GET_USERS_IDENTITIES2` | Show User Identity | Tool to show a specific user identity by user ID and identity ID. Use when you need to retrieve detailed information about a particular identity associated with a Zendesk user. This action is read-only and idempotent - it only retrieves data without modifying anything. |
| `ZENDESK_GET_USERS_ME_SESSION` | Get Current Session | Show the currently authenticated session in Zendesk. Returns details about the active session including authentication time, last seen time, and user ID. Use when you need to verify the current session status or retrieve session metadata for the authenticated user. |
| `ZENDESK_GET_USERS_ME_SETTINGS` | Get Current User Settings | Get the settings for the currently authenticated user in Zendesk. Returns user preferences including Admin Center UI settings, Lotus UI settings (onboarding, tooltips, keyboard shortcuts), and shared views order. Use this action to retrieve the current user's personal settings and preferences. |
| `ZENDESK_GET_USERS_ORGANIZATION_MEMBERSHIPS` | List User Organization Memberships | List organization memberships for a specific Zendesk user. Use when you have a user_id and need to retrieve all organizations that user belongs to. Returns membership details including default status, view_tickets permission, and organization info. This action is read-only and idempotent - calling it multiple times with the same user_id will return the same result. |
| `ZENDESK_GET_USERS_ORGANIZATION_MEMBERSHIPS2` | Get User's Organization Membership | Get details for a specific organization membership by user ID and membership ID. Use when you have both a user ID and an organization membership ID and need to retrieve the associated membership metadata including organization details, default status, and ticket viewing permissions. This action is read-only and idempotent - calling it multiple times with the same parameters will return the same result. |
| `ZENDESK_GET_USERS_ORGANIZATIONS` | List User Organizations | List organizations associated with a specific Zendesk user. Use when you have a user_id and need to retrieve all organizations that user belongs to. Returns organization details including name, domain names, tags, and custom fields. This action is read-only and idempotent - calling it multiple times with the same user_id will return the same result. |
| `ZENDESK_GET_USERS_ORGANIZATIONS_COUNT` | Get User's Organizations Count | Returns an approximate count of organizations that a user belongs to. Use when you need to know how many organizations a specific user is associated with in Zendesk. |
| `ZENDESK_GET_USERS_ORGANIZATION_SUBSCRIPTIONS` | List User's Organization Subscriptions | List User's Organization Subscriptions - retrieves organization subscriptions for a specific user. Use when you need to get all organization subscriptions associated with a particular user, including the organization IDs and creation timestamps. Supports both cursor and offset pagination. End users only see their own subscriptions. This is a read-only operation that does not modify any data. |
| `ZENDESK_GET_USERS_PASSWORD_REQUIREMENTS` | Get User Password Requirements | Get password requirements for a specific Zendesk user. Use when you need to retrieve the password policy rules that apply to a user's password, such as minimum length, complexity requirements, or expiration policies. This action is read-only and idempotent. |
| `ZENDESK_GET_USERS_PROFILES` | Get Users Profiles | Retrieve profiles associated with a specific Zendesk user by user ID. Use when you need to look up user profile information using the Zendesk user ID. This action returns all profiles linked to the specified user account. This action is read-only and idempotent. Note: Access requires agent permissions in Zendesk (Support > People > Roles > People). |
| `ZENDESK_GET_USERS_RELATED` | Get User Related Info | Get related counts and information for a specific Zendesk user by ID. Returns metadata about assigned tickets, CC'd tickets, organization subscriptions, and requested tickets associated with the user. Use when you need to understand the scale and composition of a user's ticket activity and subscriptions in Zendesk. This is a read-only, idempotent operation. |
| `ZENDESK_GET_USERS_REQUESTED_TICKETS` | Get User's Requested Tickets | List tickets requested by a specific Zendesk user. Use when you need to retrieve all tickets where a particular user is the original requester, such as for tracking user's support history, compliance monitoring, or ticket ownership analysis. Pagination is available for large result sets; follow next_page links until null to retrieve all requested tickets. Note: This endpoint only returns tickets where the user is the requester, not tickets where they are CC'd or assigned. |
| `ZENDESK_GET_USERS_REQUESTS` | List User Requests | List ticket requests for a specific Zendesk user. Use when you need to retrieve all requests associated with a particular user ID. This is useful for viewing a user's request history or monitoring their open tickets. This action is read-only and idempotent. |
| `ZENDESK_GET_USERS_SKIPS` | List User Skips | List ticket skips for a specific user from Zendesk. Use when you need to retrieve all skip records associated with a particular user, such as when analyzing which tickets a user has skipped or reviewing their skip history. This action is read-only and idempotent. Note that archived tickets are not included in the results. |
| `ZENDESK_GET_USERS_TAGS` | Get User Tags | List all tags assigned to a specific Zendesk user. Use when you need to see what tags are associated with a particular user for organizing, filtering, or categorizing user data. This action is read-only and idempotent. |
| `ZENDESK_GET_USER_TICKETS_ASSIGNED_COUNT` | Count User Assigned Tickets | Count tickets assigned to a specific user in Zendesk. Returns an approximate count of tickets where the user is the assignee. Use when you need to know how many tickets are currently assigned to a particular user for workload analysis, reporting, or capacity planning. Note: The count is approximate and may not reflect real-time changes. The count is refreshed periodically rather than being calculated on every request. |
| `ZENDESK_GET_VIEW_DEFINITIONS` | List View Filter Definitions | List the definitions of the conditions and actions available for constructing views in Zendesk. Use this action when you need to discover what filter fields, operators, grouping options, and sorting options are available for building or modifying views. This is a read-only action that returns the schema/structure for view definitions. |
| `ZENDESK_GET_VIEWS` | List Views | List shared and personal views available to the current user in Zendesk. Use when you need to retrieve, audit, or review the views configured in your Zendesk account. Views are saved ticket filters that help organize and prioritize support work. Supports filtering by access level (personal/shared/account), active status, and group. Supports both traditional offset pagination and cursor-based pagination. |
| `ZENDESK_GET_VIEWS_ACTIVE` | List Active Views | List all active shared and personal views available in Zendesk. Use when you need to retrieve, audit, or present the view configuration in your Zendesk account. Views define how tickets are filtered, grouped, and displayed to agents. Supports filtering by access type (personal, shared, account), group membership, and sorting preferences. |
| `ZENDESK_GET_VIEWS_COMPACT` | List Views - Compact | Retrieves a compacted list of shared and personal views available to the current user in Zendesk. Use when you need to quickly fetch a lightweight list of views without full details. This endpoint returns essential view information suitable for dropdown menus or quick selection lists. Unlike the standard /views endpoint, this compact version provides a streamlined response with the most commonly needed fields. |
| `ZENDESK_GET_VIEWS_COUNT` | Count Views | Count shared and personal views in Zendesk. Returns an approximate count of all views (both shared and personal) available in the account. Use when you need to know the total number of views configured for reporting or operational purposes. |
| `ZENDESK_GET_VIEWS_COUNT_MANY` | Count Tickets in Views | Count tickets in multiple Zendesk views. Returns the ticket count for each view ID provided in a single API call. Use when you need to quickly get counts for multiple views at once for reporting or dashboard purposes. Note: This is a read-only, idempotent operation. Counts may be cached on the server side. |
| `ZENDESK_GET_VIEWS_EXECUTE` | Execute View | Execute a Zendesk view to retrieve its column titles and matching ticket rows. Use when you need to run a saved view and get its results - useful for checking which tickets match a view's conditions without manually applying filters. Supports pagination, custom sorting, and optional grouping of results. Returns the view's execution metadata alongside the matching rows. |
| `ZENDESK_GET_VIEWS_EXPORT` | Export View | Export a Zendesk view as a CSV file. Use when you need to download view data for offline analysis, reporting, or data migration purposes. The export contains all tickets matching the view's filter criteria and columns. Note that if the export is not immediately available, Zendesk may return a status indicating the job is queued - retry after a short delay in such cases. Note: This action downloads file content and may take longer for views with large datasets. |
| `ZENDESK_GET_VIEWS_SEARCH` | Search Views | Search for Zendesk views by their title. Use when you need to find views in your Zendesk account by searching for keywords in their titles. Views are saved searches that display tickets matching specific conditions. This action supports filtering by access level, active status, group, and sorting results. |
| `ZENDESK_GET_VIEWS_SHOW_MANY` | List Views By IDs | Get multiple Zendesk views by their IDs. Use when you need to retrieve specific views by their IDs in a single request rather than fetching them one by one. The IDs should be provided as a comma-separated string. This action is read-only and idempotent. Returns only views that exist and for which the user has permission. |
| `ZENDESK_GET_VIEWS_TICKETS` | List Tickets From View | List tickets from a specific Zendesk view. Use this action when you need to retrieve all tickets that match a view's conditions, such as for reporting, bulk operations, or analyzing tickets filtered by specific criteria. This action is read-only and idempotent. |
| `ZENDESK_GET_VIEW_TICKET_COUNT` | Count Tickets in View | Count tickets in a specific view in Zendesk. Returns the number of tickets matching the view's conditions. Use when you need to know how many tickets are in a particular view for reporting, routing decisions, or workload assessment. The count may be null if the system is still loading and caching new data. This action is read-only and idempotent. |
| `ZENDESK_GET_ZENDESK_ACTIVITIES` | List Activities | List ticket activities in the last 30 days affecting your Zendesk. Activities include actions like ticket assignments, status changes, comments, and more. This action is read-only and idempotent — use it to monitor ticket activity or build activity feeds. |
| `ZENDESK_GET_ZENDESK_CUSTOM_ROLES` | List Custom Roles | List all custom roles configured in your Zendesk account. Use when you need to discover available roles, review role configurations, or understand permission structures for your agents. Returns metadata including role names, descriptions, role types, and permission configurations. This is a read-only, idempotent operation with no required parameters. |
| `ZENDESK_GET_ZENDESK_ORGANIZATION` | Get Zendesk Organization | Get metadata for a specific Zendesk organization by ID. Response fields are available under data.organization_info. Does not return member/user lists. |
| `ZENDESK_GET_ZENDESK_ORGANIZATION_MERGE` | Get Zendesk Organization Merge | Retrieve the details of a specific organization merge operation in Zendesk. This action shows the merge status and the organizations involved. Use when you need to check the status of an organization merge or view details of a past merge operation. This is a read-only, idempotent operation. |
| `ZENDESK_GET_ZENDESK_ORGANIZATIONS_SUBSCRIPTIONS` | List Organization Subscriptions | List all organization subscriptions for a specific Zendesk organization. Returns subscriptions that link users to organizations. Use when you need to see which users are subscribed to a particular organization or audit organization membership. This action is read-only and idempotent. Paginate by following next_page until null to avoid missing subscriptions. |
| `ZENDESK_GET_ZENDESK_REQUESTS` | List Requests | List ticket requests in Zendesk. This action retrieves a paginated list of requests, supporting sorting by creation or update time. Use when you need to fetch all or filtered ticket requests from your Zendesk account. This action is read-only and idempotent. |
| `ZENDESK_GET_ZENDESK_SESSIONS` | List Sessions | List all active sessions in your Zendesk account. If authenticated as an admin, returns all the active sessions for all users. Otherwise, returns only the sessions for the authenticated user. Use this action to monitor active user sessions, track login activity, or manage session security. Use when you need to audit active user sessions, investigate security events, or retrieve session information for user activity monitoring. |
| `ZENDESK_GET_ZENDESK_SHARING_AGREEMENTS` | List Sharing Agreements | List all sharing agreements for your Zendesk account. Sharing agreements define connections between Zendesk accounts for sharing tickets. This action is read-only and idempotent — use it to view current sharing relationships or check agreement status. |
| `ZENDESK_GET_ZENDESK_SUSPENDED_TICKETS` | List Suspended Tickets | List suspended tickets in Zendesk. Suspended tickets are tickets that were automatically held for review due to spam detection, banned content, or other filtering rules. This action is read-only and idempotent — use it to review suspended tickets and determine if they should be recovered or deleted. |
| `ZENDESK_GET_ZENDESK_TICKET_BY_ID` | Get Zendesk Ticket | Get ticket details from Zendesk. Response wraps all data under a top-level `data` key; access `data['comments']` for comments and `data['comments'][i]['attachments']` for attachments (attachments unavailable from list endpoints). Each comment has both `html_body` and plain `body` fields — choose appropriately. Fields like `subject`, `organization_id`, `author_id`, and `body` may be null; handle defensively. First comment in `data.comments` is not necessarily from the requester — compare `author_id` against ticket `requester_id` to identify requester messages. For bulk calls, honor `Retry-After` headers on HTTP 429. |
| `ZENDESK_GET_ZENDESK_TICKET_FIELDS_OPTIONS` | List Ticket Field Options | List Ticket Field Options - Returns a list of custom ticket field options for dropdown and multi-select ticket fields. Use this action to retrieve the available choices users can select when filling out a custom ticket field. This action is read-only and idempotent. Note: Only works with dropdown, tagger, and multi-select custom ticket fields; standard fields like text or date do not have options. |
| `ZENDESK_GET_ZENDESK_TICKET_FIELDS_OPTIONS2` | Show Ticket Field Option | Show Ticket Field Option - Retrieves a specific custom ticket field option for dropdown and multi-select ticket fields. Use this action when you have a ticket_field_id and a ticket_field_option_id and need to retrieve the details of that individual option. This action is read-only and idempotent. Note: Only works with dropdown, tagger, and multi-select custom ticket fields; standard fields like text or date do not have options. |
| `ZENDESK_GET_ZENDESK_TICKET_FORM` | Get Zendesk Ticket Form | Get details for a specific ticket form in Zendesk by its ID. Returns the complete ticket form object including its name, display settings, visibility conditions, associated ticket fields, and brand restrictions. Use when you need to retrieve detailed information about a particular ticket form configuration. This is a read-only, idempotent operation that does not modify any data. |
| `ZENDESK_GET_ZENDESK_TICKET_RELATED` | Get Zendesk Ticket Related | Get related information for a specific Zendesk ticket. This endpoint returns data about tickets that are related to the specified ticket, including follow-up sources, associated Jira issues, and incident counts. Use this action when you need to understand the relationships and connections between tickets in Zendesk. |
| `ZENDESK_GET_ZENDESK_TICKETS_SIDE_CONVERSATION_ID` | Get Side Conversation | Get a specific side conversation by its ID for a Zendesk ticket. Side conversations are private agent-to-agent communications that don't notify the customer. Use this action when you need to retrieve details about a specific side conversation on a ticket, such as its current state, participants, or message history. If the side conversation is a child ticket, the external_ids object's targetTicketId property contains the child ticket's ID. |
| `ZENDESK_GET_ZENDESK_TICKETS_TAGS` | Get Ticket Tags | List all tags associated with a specific Zendesk ticket. Use when you need to retrieve the tags assigned to a particular ticket for categorization, filtering, or reporting purposes. |
| `ZENDESK_LIST_ACTIVE_AUTOMATIONS` | List Active Automations | List all active automations in Zendesk. Use when you need to retrieve the currently active automation rules that automatically perform actions based on ticket conditions. This action returns all automations marked as active, including their conditions and actions. Note: This only returns active automations; to see all automations including inactive ones, you would need a different action. |
| `ZENDESK_LIST_APP_INSTALLATIONS` | List App Installations | List all app installations in the Zendesk account. The 'enabled' property indicates whether each installed app is active in the product. Use the 'include' parameter to sideload app object details for each installation. |
| `ZENDESK_LIST_APP_LOCATIONS` | List App Locations | List all available locations where Zendesk apps can be installed. Use when you need to discover valid placement options for installing or configuring Zendesk apps. This endpoint requires admin authentication. All returned locations are read-only. |
| `ZENDESK_LIST_ASSIGNABLE_GROUP_MEMBERSHIPS` | List Assignable Group Memberships | List assignable group memberships in Zendesk. Use when you need to retrieve the group memberships that agents can be assigned to, typically for understanding agent-group assignments or building assignment interfaces. This action is read-only and idempotent. Returns a maximum of 100 group memberships per page. |
| `ZENDESK_LIST_ASSIGNABLE_GROUP_MEMBERSHIPS_BY_GROUP` | List Assignable Memberships By Group | List assignable group memberships for a specific group in Zendesk. Use when you need to retrieve which agents can be assigned to a particular group, typically for building assignment interfaces or auditing group membership capabilities. This action is read-only and idempotent. Returns a maximum of 100 group memberships per page. Note: This action differs from ListAssignableGroupMemberships by filtering to a specific group rather than returning all assignable memberships. |
| `ZENDESK_LIST_BOOKMARKS` | List Bookmarks | List Bookmarks returns all bookmarks created by the user. Use when you need to retrieve all bookmarks to find saved tickets or manage bookmarked items. Archived tickets are not included in the response. _tags = ["readOnlyHint", "idempotentHint"] |
| `ZENDESK_LIST_BRAND_AGENTS` | List Brand Agent Memberships | List brand agent memberships to retrieve which agents are associated with which brands in Zendesk. Use this action when you need to enumerate the brand-agent relationships in a Zendesk account, such as determining which agents can access specific brands or auditing brand access permissions. This is a read-only, idempotent operation. |
| `ZENDESK_LIST_CUSTOM_OBJECT_RECORD_ATTACHMENTS` | List Custom Object Record Attachments | List all file attachments for a specific custom object record in Zendesk. Use this action when you need to retrieve the attachments associated with a particular custom object record, for example to display files, verify uploads, or manage attachments for a record. This is a read-only operation that retrieves attachment metadata without downloading file content. |
| `ZENDESK_LIST_CUSTOM_OBJECT_RECORDS` | List Custom Object Records | List all records for a specific custom object type in Zendesk. Use this action when you need to retrieve all instances of a custom object (e.g., all car records, all product records) with optional filtering by ID, external ID, sorting, and pagination support. This is a read-only, idempotent operation that returns records with their custom field values. Note: When using pagination (page[size], page[after], page[before]), you cannot mix page[before] and page[after] in the same request. |
| `ZENDESK_LIST_DELETED_USERS` | List Deleted Users | Tool to list deleted users in Zendesk via the Users API. Use when you need to retrieve information about users that have been deleted from the system. This is a read-only operation. |
| `ZENDESK_LIST_INCREMENTAL_CUSTOM_OBJECT_RECORDS` | List Incremental Custom Object Records | Export custom object records incrementally using cursor-based pagination. Use this action when you need to retrieve all changes to custom object records since a specific time, with support for large result sets through cursor-based pagination. The start_time parameter is required for the initial request; subsequent pages use the cursor returned in previous responses. This is a read-only, idempotent operation that returns records with their custom field values and change timestamps. The action supports filtering to exclude deleted records and configurable page sizes. Rate limited to 10 requests per minute. |
| `ZENDESK_LIST_MONITORED_TWITTER_HANDLES` | List Monitored X Handles | List all monitored X (Twitter) handles configured in your Zendesk account. Use when you need to retrieve all Twitter handles that are being monitored for the X channel integration. This is a read-only, idempotent operation. |
| `ZENDESK_LIST_OBJECT_TRIGGERS` | List Object Triggers | List all triggers for a specific custom object in Zendesk. Use when you need to discover, audit, or review the triggers configured for a custom object type. Triggers are business rules that automatically perform actions based on conditions. This action retrieves triggers associated with a custom object defined in your Zendesk instance. Each trigger defines conditions and corresponding actions that run when records meet those conditions. |
| `ZENDESK_LIST_OBJECT_TRIGGERS_DEFINITIONS` | List Object Trigger Definitions | List Object Trigger Action and Condition Definitions for a custom object in Zendesk. Use when you need to discover the available trigger actions and conditions that can be used to create or configure triggers on a custom object. This returns metadata about what types of automations are possible for the specified custom object. This is a read-only, idempotent operation that returns the available trigger definitions. |
| `ZENDESK_LIST_ORGANIZATION_MEMBERSHIPS` | List Organization Memberships | List organization memberships in Zendesk. Use when you need to retrieve all organization memberships, which link users to organizations. Supports pagination and sorting options to navigate large result sets efficiently. |
| `ZENDESK_LIST_ORGANIZATION_MEMBERSHIPS_BY_ORGANIZATION` | List Organization Memberships by Organization | List organization memberships for a specific organization in Zendesk. Use when you need to retrieve all users who are members of a particular organization, including their membership metadata like default status and ticket viewing permissions. Supports pagination and sorting options to navigate large result sets efficiently. This action is read-only and idempotent - calling it multiple times with the same organization ID will return the same result. |
| `ZENDESK_LIST_RESOURCE_COLLECTIONS` | List Resource Collections | List Resource Collections for the Zendesk account. Use when you need to retrieve, audit, or review the resource collections configured in your Zendesk account. Resource collections are groups of related resources that can be managed together. This is a read-only action that returns paginated results. Use per_page to control page size. |
| `ZENDESK_LIST_SKIPS` | List All Skips | Lists all ticket skips in Zendesk. A skip is a ticket that was skipped during routing or assignment. Use this action to retrieve information about all tickets that have been skipped. This action is read-only and idempotent. Note that archived tickets are not included in the results. |
| `ZENDESK_LIST_SUPPORT_ADDRESSES` | List Support Addresses | List all support addresses (recipient addresses) configured in your Zendesk account. Use when you need to enumerate available support email addresses, check which address is set as default, or retrieve address metadata like verification status and brand associations. This is a read-only, idempotent operation that supports both cursor and offset pagination. |
| `ZENDESK_LIST_TICKET_AUDITS` | List Ticket Audits | List all ticket audits from Zendesk. Returns a paginated list of audit records, each containing events that describe changes made to tickets. Audits capture all changes including comments, status changes, assignments, and field updates. Archived tickets are not included in the results. Use cursor pagination (page_after, page_before, page_size) to navigate through results efficiently. |
| `ZENDESK_LIST_TICKET_CONTENT_PINS` | List Ticket Content Pins | List Ticket Content Pins returns all content pins for a specified ticket. Use when you need to retrieve all pinned content items on a ticket. If ticket_id is not provided, returns all content pins for the account. _tags = ["readOnlyHint", "idempotentHint"] |
| `ZENDESK_LIST_USER_IDENTITIES` | List User Identities | Tool to list all identities for a specific Zendesk user. Use when you need to retrieve all email addresses, phone numbers, or other contact methods associated with a user. Supports filtering by identity type and cursor-based pagination. |
| `ZENDESK_LIST_ZENDESK_ACCESS_RULES` | List Access Rules | List all access rules for a Zendesk custom object. Access rules control which users and roles can perform specific operations on custom object records. Use this action when you need to audit existing permissions or understand what access controls are in place for a custom object type. This is a read-only operation. |
| `ZENDESK_LIST_ZENDESK_CUSTOM_OBJECT_FIELDS` | List Custom Object Fields | List all fields for a custom object in Zendesk. Use this action when you need to discover the structure of a custom object, understand what fields are available, or retrieve metadata about custom object fields for further operations like creating or updating records. |
| `ZENDESK_LIST_ZENDESK_CUSTOM_OBJECTS` | List Custom Objects | List all custom object definitions in Zendesk. Use this action when you need to discover available custom object types, understand their structure, or retrieve metadata about custom objects for further operations. Returns metadata including keys, titles, and configuration options for each custom object. |
| `ZENDESK_LIST_ZENDESK_PERMISSION_POLICIES` | List Permission Policies | List all permission policies for a custom object in Zendesk. Use this action when you need to discover the access control configuration for a custom object, understand what roles have permissions, or retrieve permission metadata for access control management. This is a read-only, idempotent operation. This action is useful for reviewing permission policies applied to custom objects in Zendesk. |
| `ZENDESK_LIST_ZENDESK_TICKETS` | List Tickets | List Zendesk tickets with pagination and filtering. Only server-side filter available is external_id; status, priority, tags, assignee_id, and date-range filters must be applied client-side. Timestamps (created_at, updated_at) are ISO 8601 UTC. ticket.subject may be null — coerce to string before filtering. Attachments are not included; retrieve via ZENDESK_GET_ZENDESK_TICKET_BY_ID. HTTP 429 rate limit responses include Retry-After header; apply exponential backoff. Paginate by following next_page until null to avoid missing tickets. |
| `ZENDESK_LIST_ZENDESK_USERS` | List Users | Tool to list/enumerate Zendesk users via the Users API. Use when you need to export or iterate through the user directory without a specific name/email filter. Supports both cursor and offset pagination. |
| `ZENDESK_MAKE_COMMENT_PRIVATE` | Make Zendesk Ticket Comment Private | Make a public ticket comment private in Zendesk. This action changes the visibility of a comment from public to internal-only, so only agents can view it. Use this action when you need to convert a customer-facing comment to an internal note after the fact. Note: Only agents can make comments private; end users cannot use this endpoint. |
| `ZENDESK_MAKE_DEFAULT_ORGANIZATION_MEMBERSHIP` | Make Organization Membership Default | Set a specific organization membership as the default for a user in Zendesk. Use when you need to change which organization is the primary/default for a user. Only one organization can be the default at a time. This action is idempotent - setting the same membership as default multiple times will succeed without side effects. |
| `ZENDESK_MAKE_END_USER_IDENTITY_PRIMARY` | Make End User Identity Primary | Set a specified identity as the primary identity for an end user in Zendesk. This is a collection-level operation - after making an identity primary, you should reload the entire identities collection to get the updated state. An end user can only make an email identity primary if the email is verified. Use when a user wants to change their primary email or phone number for notifications. |
| `ZENDESK_MAKE_TICKET_COMMENT_PRIVATE` | Make Ticket Comment Private | Change a public comment to private on a Zendesk ticket audit. Use when you need to convert a previously public-facing comment to an internal note that is not visible to the end user. This action makes the comment private by updating the ticket audit. This is useful when information was shared publicly by mistake and needs to be restricted to agents only. Note: This action only works on existing audits and cannot be undone once the comment is made private. |
| `ZENDESK_MAKE_USER_IDENTITY_PRIMARY` | Make User Identity Primary | Tool to set a user identity as the primary identity for a Zendesk user. Use when you need to change which email address or identifier is the primary contact method for a user. This action may affect which email notifications the user receives. |
| `ZENDESK_MARK_MANY_TICKETS_AS_SPAM` | Mark Multiple Tickets as Spam | Marks multiple tickets as spam in Zendesk. This action is irreversible — the tickets will be marked as spam and moved to the suspended tickets queue. The submitter will also be marked as spam and blocked from submitting further tickets. Use when cleaning up spam or unwanted tickets to protect your support queue. Returns a job_status payload for tracking the bulk operation. Note: Tickets marked as spam are moved to the suspended tickets queue and cannot be recovered through normal means. |
| `ZENDESK_MERGE_USERS` | Merge Users | Merges two Zendesk end users together. The user specified in the path parameter (user_id) is the primary user (target) that will be kept. The user specified in the request body (id) is the source user that will be deleted and its data transferred to the primary user. Use when you need to consolidate duplicate end-user accounts in Zendesk. This action is irreversible — the source user and all their associated data (tickets, comments, etc.) will be merged into the primary user and the source user cannot be recovered. |
| `ZENDESK_MERGE_ZENDESK_TICKETS` | Merge Zendesk Tickets | Merges multiple tickets into a target ticket in Zendesk. The source tickets are merged into the target ticket and then deleted. This is an asynchronous operation that returns a job status. Use when you need to consolidate duplicate or related tickets into a single ticket. **Important**: This action is irreversible - source tickets are permanently merged and deleted once the operation completes. Always verify the target_ticket_id and source_ticket_ids before executing. |
| `ZENDESK_OPEN_USERS_PROFILE_IN_AGENT_BROWSER` | Open User's Profile in Agent Browser | Open a Zendesk user's profile in a specified agent's browser. Use when an agent needs to view a specific user's profile during an active call or session. This action triggers the Zendesk Talk dashboard to display the user's information in the agent's interface. |
| `ZENDESK_RECOVER_MANY_SUSPENDED_TICKETS` | Recover Multiple Suspended Tickets | Recover multiple suspended tickets in Zendesk. Use when you need to restore tickets that have been suspended (e.g., auto-replied emails, bounced messages). Takes up to 100 ticket IDs as input and restores them to normal ticket status. This action is irreversible — recovered tickets return to normal processing. |
| `ZENDESK_RENEW_SESSION` | Renew Session | Renew the current Zendesk session and obtain a new authenticity token. Use when the current session token is expiring or needs to be refreshed to maintain an active authenticated connection. This action extends the session lifetime without requiring full re-authentication. |
| `ZENDESK_REORDER_CUSTOM_OBJECT_FIELDS` | Reorder Custom Object Fields | Reorder Custom Fields of an Object. Updates the display order of custom object fields based on the provided field IDs. Use when you need to change the order of fields displayed in a custom object's record layout. This action is idempotent — re-running with the same field IDs in the same order will produce the same result. |
| `ZENDESK_REORDER_LOCATION_INSTALLATIONS` | Reorder App Location Installations | Reorder App Installations For Location. Creates or updates the relevant location installation with a specified installation order. This action requires admin-level access. Use when you need to change the display order of apps in a specific Zendesk location (e.g., nav bar, ticket sidebar). |
| `ZENDESK_REORDER_ORGANIZATION_FIELDS` | Reorder Organization Fields | Reorder Organization Fields. Updates the display order of organization fields based on the provided field IDs. Use when you need to change the order of organization fields displayed in Zendesk. This action is idempotent — re-running with the same field IDs in the same order will produce the same result. |
| `ZENDESK_REORDER_TICKET_FIELDS` | Reorder Ticket Fields | Reorder Ticket Fields. Updates the display order of ticket fields based on the provided field IDs. Use when you need to change the order of standard ticket fields displayed in the ticket form. This action is idempotent — re-running with the same field IDs in the same order will produce the same result. This action requires admin permissions. |
| `ZENDESK_REORDER_TRIGGERS` | Reorder Ticket Triggers | Reorder Ticket Triggers. Updates the firing order of ticket triggers based on the provided trigger IDs. Use when you need to change the priority or execution order of ticket triggers in your Zendesk account. Important constraints: You must include EVERY ticket trigger ID in your account. Omitting any trigger ID returns 404 Forbidden. Additionally, reordering is not permitted if you have more than one ticket trigger category (returns LimitOneCategory error). This action is idempotent - re-running with the same trigger IDs in the same order will produce the same result. |
| `ZENDESK_REORDER_USER_FIELDS` | Reorder User Fields | Reorder User Fields. Updates the display order of custom user fields based on the provided field IDs. Use when you need to change the order of user fields displayed in user profiles or forms. This action requires admin-level access. This action is idempotent — re-running with the same field IDs in the same order will produce the same result. |
| `ZENDESK_REPLY_ZENDESK_TICKET` | Reply to Zendesk Ticket | Action to reply to a Zendesk ticket by adding a comment. |
| `ZENDESK_REQUEST_END_USER_VERIFICATION` | Request End User Verification | Send a verification email to an end user to verify ownership of their email address identity. The end user receives an email with a link to confirm their identity. Use when you need to verify an end user's email address identity in Zendesk, such as when creating new end users or resolving identity verification issues. Note: This action can only be performed by verified end users. |
| `ZENDESK_REQUEST_USER_CREATE` | Request User Create | Send a request to create a user in Zendesk. This sends the owner a reminder email to update their user profile information. Use when you want to prompt a user to complete their profile through the request flow rather than creating directly. This action is useful for onboarding flows where you want to collect user information through an email-based request rather than creating the user directly. |
| `ZENDESK_REQUEST_USER_VERIFICATION` | Request User Verification | Send a verification email to a user to verify ownership of their email address identity. The user receives an email with a link to confirm their identity. Use when you need to verify a user's email address identity in Zendesk, such as when creating new users or resolving identity verification issues. Note: This action sends a verification email to the user's identity address. |
| `ZENDESK_RESTORE_MANY_TICKETS` | Restore Multiple Deleted Tickets | Restores multiple previously deleted tickets in Zendesk. Use when you need to recover tickets that were deleted and need to be restored in bulk. This action is reversible - tickets can be deleted again after restoration. Note: Only tickets in 'deleted' status can be restored. |
| `ZENDESK_RESTORE_ZENDESK_TICKET` | Restore Zendesk Ticket | Restores a previously deleted ticket in Zendesk. Use when a ticket was accidentally deleted and needs to be recovered. The restored ticket will return to its previous state with all associated data intact. This action is reversible — tickets can be deleted again after restoration if needed. |
| `ZENDESK_SEARCH_CUSTOM_OBJECT_RECORDS` | Search Custom Object Records | Search and filter custom object records in Zendesk using text queries and field filters. Returns paginated results with cursor-based navigation. Use when you need to find specific records within a custom object type, apply text searches or structured filters, and navigate through large result sets. This is a read-only operation. This action is useful for discovering records, running filtered queries on custom objects, and implementing paginated browsing through custom object data. |
| `ZENDESK_SEARCH_OBJECT_TRIGGERS` | Search Object Triggers | Search for triggers associated with a custom object in Zendesk. Use when you need to find triggers based on their title, description, or active status within a specific custom object. This is useful for auditing, managing, or reviewing automation rules for custom objects. Supports both cursor-based pagination (using 'sort' parameter) and offset pagination (using 'sort_by' parameter). Filter by 'active' to show only enabled or disabled triggers. |
| `ZENDESK_SEARCH_ZENDESK` | Search Zendesk | Tool to search for tickets, users, organizations, and groups in Zendesk using query syntax. Use when you need to find resources across Zendesk using flexible search criteria. |
| `ZENDESK_SEARCH_ZENDESK_ORGANIZATIONS` | Search Organizations | Search organizations in Zendesk by external ID or name. Returns an array of organizations matching the provided criteria. Use when you need to find specific organizations by their identifier or name. An empty organizations array with count=0 means no matches found. Multiple organizations may share similar names — verify the correct organization via external_id or domain_names before proceeding with operations. |
| `ZENDESK_SEARCH_ZENDESK_USERS` | Search Zendesk Users | Search for Zendesk users by query or external ID. Use when you need to find users using flexible search criteria with Zendesk search syntax (e.g., partial name matches, email patterns, notes, phone numbers). For exact email lookups, consider using the 'Search Zendesk Users' action instead. |
| `ZENDESK_SET_DEFAULT_CUSTOM_STATUS` | Set Default Custom Ticket Status | Sets one or more custom ticket statuses as the default for their respective categories. Use this action when you need to specify which custom status should be the default (fallback) status for a given category (open, pending, solved, etc.). This operation is idempotent — running it multiple times with the same IDs will produce the same result. **Allowed for**: Admins only. **Note**: The IDs should be valid custom ticket status IDs that exist in your Zendesk account. |
| `ZENDESK_SET_GROUP_MEMBERSHIP_AS_DEFAULT` | Set Group Membership as Default | Set a group membership as the default for a specific user in Zendesk. Use when you need to mark a user's group membership as the default, meaning tickets assigned directly to the agent will assume this membership's group. Requires both the user ID and the group membership ID. This action is useful for managing default routing preferences for agents in your Zendesk instance. Note that only one group membership can be the default at a time - setting a new default will automatically unset the previous default. |
| `ZENDESK_SET_USERS_ORGANIZATION_AS_DEFAULT` | Set Organization as Default for User | Set an organization as the default for a user in Zendesk. Use when you need to change which organization is the primary/default for a user by specifying the organization ID directly. Only one organization can be the default at a time. This action is idempotent - setting the same organization as default multiple times will succeed without side effects. |
| `ZENDESK_SHOW_ACCESS_RULE` | Show Access Rule | Show a custom object access rule by its ID. Use when you have a custom_object_key and access_rule_id and need to retrieve the access rule's details including its conditions, title, description, and timestamps. This is a read-only operation that does not modify any data. This action is useful for reviewing access control rules applied to custom objects in Zendesk. |
| `ZENDESK_SHOW_CUSTOM_OBJECT` | Show Custom Object | Get details of a specific Zendesk custom object by its key. Use when you have a custom object key and need to retrieve its metadata including name, description, attachment settings, visibility settings, and creation/update timestamps. This is a read-only, idempotent operation that returns the full custom object definition. |
| `ZENDESK_SHOW_CUSTOM_OBJECT_RECORD` | Show Custom Object Record | Get details of a specific Zendesk custom object record by its key and record ID. Use when you have a custom object key and record ID and need to retrieve the record's metadata including name, custom fields, timestamps, and photo. This is a read-only, idempotent operation that returns the full custom object record definition. Photo is only available if `allows_photos` is enabled on the custom object. |
| `ZENDESK_SHOW_MANY_JOB_STATUSES` | Show Many Job Statuses | Show many job statuses by their IDs in Zendesk. Use this action when you have multiple job status IDs from bulk operations (like ticket updates, user merges, or ticket merges) and need to check their status in a single request. Each ID in the comma-separated list will return its corresponding job status object if found. Endpoint: GET /api/v2/job_statuses/show_many |
| `ZENDESK_SHOW_MANY_TICKETS` | Show Many Tickets | Show multiple tickets by their IDs. Use when you need to retrieve specific tickets by their IDs to display ticket details, compare tickets, or bulk fetch ticket information. The `ids` parameter accepts a comma-separated list of ticket IDs (e.g., '35436,35437'). Returns tickets for valid IDs only; non-existent IDs result in an empty tickets array without error. |
| `ZENDESK_SHOW_MANY_USERS` | Show Many Users | Retrieve multiple Zendesk users by their numeric IDs or external IDs. Use when you have a list of user IDs (from ticket payloads, search results, etc.) and need to fetch full user details for multiple users at once. Accepts up to 100 IDs per request. Provide either `ids` or `external_ids`, not both. |
| `ZENDESK_SHOW_PERMISSION_POLICY` | Show Permission Policy | Get details of a specific permission policy for a Zendesk custom object by its ID. Use when you have a custom_object_key and permission policy ID and need to retrieve the policy's details including the role name and record operation permissions (create, read, update, delete). This is a read-only, idempotent operation that does not modify any data. This action is useful for reviewing permission policies that control access to custom object records in Zendesk. |
| `ZENDESK_SHOW_REQUEST` | Show Request | Show a single request in Zendesk. Use when you need to retrieve details of a specific request by its ID, including subject, description, status, priority, requester information, and other metadata. This action is read-only and idempotent. |
| `ZENDESK_UNASSIGN_USER_ORGANIZATION` | Unassign User from Organization | Immediately removes a user from an organization in Zendesk. Use when you need to unassign a user from an organization membership. This action is irreversible - the user will no longer be associated with the organization. |
| `ZENDESK_UPDATE_ACCESS_RULE` | Update Access Rule | Update an existing access rule for a custom object in Zendesk. Access rules control which records of a custom object users can access based on conditions. Use this action when you need to: - Change an access rule's title or description - Modify the conditions that determine when the rule applies - Update access permissions for custom object records This action is idempotent — re-running with the same parameters will produce the same result. |
| `ZENDESK_UPDATE_APPS_INSTALLATION` | Update Zendesk App Installation | Update an app installation in Zendesk. Use when you need to modify app installation settings such as enabling/disabling the app, restricting access by groups or roles, or updating app-specific settings. |
| `ZENDESK_UPDATE_AUTOMATION` | Update Automation | Update an existing automation in Zendesk. Automations are business rules that automatically perform actions on tickets when certain conditions are met. Use this action when you need to: - Change an automation's title, active status, or position - Modify the conditions that trigger the automation - Update the actions the automation performs - Deactivate an automation without deleting it This action is idempotent — re-running with the same parameters will produce the same result. |
| `ZENDESK_UPDATE_CUSTOM_OBJECT` | Update Custom Object | Update an existing custom object in Zendesk. Custom objects are user-defined data structures that allow you to store and manage custom data types. Use this action when you need to: - Change a custom object's title, description, or pluralized title - Update visibility settings (include_in_list_view) - Enable or disable attachments and photos for the custom object This action is idempotent — re-running with the same parameters will produce the same result. |
| `ZENDESK_UPDATE_CUSTOM_OBJECT_RECORD` | Update Custom Object Record | Update an existing record for a custom object in Zendesk. Use when you need to modify an existing custom object record. This action updates fields on a custom object record. You can update the name, external_id, and custom_object_fields as needed. |
| `ZENDESK_UPDATE_CUSTOM_STATUS` | Update Custom Ticket Status | Update an existing custom ticket status in Zendesk. Custom ticket statuses allow you to define additional statuses beyond the standard statuses (new, open, pending, solved, closed) for your ticket workflow. Use this action when you need to: - Change the labels shown to agents or end users for a custom status - Update the descriptions explaining when to use the status - Activate or deactivate a custom status - Modify how a custom status appears in the ticket interface This action is idempotent — re-running with the same parameters will produce the same result. Requires admin permissions in Zendesk. |
| `ZENDESK_UPDATE_DELETION_SCHEDULE` | Update Deletion Schedule | Update an existing deletion schedule in Zendesk. Deletion schedules define automated rules for deleting tickets, users, attachments, or other records based on specified conditions. Use this action when you need to: - Change a deletion schedule's title, description, or active status - Modify the conditions that determine which records are deleted - Pause or reactivate a deletion schedule This action is idempotent — re-running with the same parameters will produce the same result. Note: The 'object' field cannot be modified after schedule creation. |
| `ZENDESK_UPDATE_DYNAMIC_CONTENT_ITEMS_VARIANT` | Update Dynamic Content Variant | Update a single variant of a dynamic content item in Zendesk. Use when you need to modify the content, locale, active status, or default status of one specific variant by its ID. This action is idempotent — re-running with the same parameters will produce the same result. |
| `ZENDESK_UPDATE_DYNAMIC_CONTENT_ITEMS_VARIANTS` | Update Many Dynamic Content Variants | Update one or more variants of a dynamic content item in Zendesk. Use when you need to bulk update variant content, active status, or default status for a specific dynamic content item. Each variant can be identified by either its ID or locale ID. This action is idempotent — re-running with the same parameters will produce the same result. |
| `ZENDESK_UPDATE_MACRO` | Update Macro | Update an existing macro in Zendesk. Macros are predefined responses that agents can apply to tickets to quickly perform common actions. Use this action when you need to: - Change a macro's title or description - Modify the actions the macro performs (e.g., change status, priority, or assignee) - Activate or deactivate a macro - Restrict macro access to specific users or groups This action is idempotent — re-running with the same parameters will produce the same result. |
| `ZENDESK_UPDATE_MANY_AUTOMATIONS` | Update Many Automations | Update multiple automations in Zendesk in a single request. Use when you need to bulk update automation settings such as position, active status, or title for multiple automations at once. Note: You might be restricted from updating some default automations. If included in a bulk update, the unrestricted automations will be updated. This action is idempotent — re-running with the same parameters will produce the same result. |
| `ZENDESK_UPDATE_MANY_MACROS` | Update Many Macros | Update multiple macros in Zendesk in a single request. Use when you need to bulk update macro settings such as position or active status for multiple macros at once. This action is idempotent — re-running with the same parameters will produce the same result. |
| `ZENDESK_UPDATE_MANY_OBJECT_TRIGGERS` | Update Many Object Triggers | Update multiple custom object triggers in Zendesk in a single request. Use when you need to bulk update trigger settings such as position, active status, or title for multiple custom object triggers at once. This action is idempotent — re-running with the same parameters will produce the same result. |
| `ZENDESK_UPDATE_MANY_ORGANIZATIONS` | Update Many Zendesk Organizations | Bulk update multiple Zendesk organizations in a single request. Use when you need to update organization details such as name, notes, details, domain names, or tags for multiple organizations at once. The action is queued as a background job - use the job_status URL to poll for completion. Maximum 100 organizations per request. Note: Agents without permission restrictions can only update 'notes' on organizations. |
| `ZENDESK_UPDATE_MANY_TICKETS` | Update Many Tickets | Update multiple tickets in Zendesk in a single request. Use when you need to bulk update ticket fields such as status, priority, tags, assignee, or group for multiple tickets at once. The API accepts up to 100 ticket objects per request. Changes are processed asynchronously and return a job_status object for tracking progress. |
| `ZENDESK_UPDATE_MANY_TRIGGERS` | Update Many Ticket Triggers | Update multiple ticket triggers in Zendesk in a single request. Use when you need to bulk update trigger settings such as position, active status, or category for multiple triggers at once. This action allows you to update the order (position) or activate/deactivate multiple triggers efficiently. This action is idempotent — re-running with the same parameters will produce the same result. |
| `ZENDESK_UPDATE_MANY_USERS` | Update Many Users | Bulk update multiple Zendesk users in a single request. Use when you need to apply the same or different updates to up to 100 users at once. Provide either a single `user` object to apply identical changes to all specified users, or an array of `users` objects for individual updates per user. The operation is asynchronous and returns a job_status that you can poll to track completion. This action is idempotent — re-running with the same parameters will apply the same updates again. |
| `ZENDESK_UPDATE_MANY_VIEWS` | Update Many Views | Update multiple views in Zendesk in a single request. Use when you need to bulk update view settings such as position, active status, or title for multiple views at once. Note: You might be restricted from updating some default views. If included in a bulk update, the unrestricted views will be updated. This action is idempotent — re-running with the same parameters will produce the same result. |
| `ZENDESK_UPDATE_OBJECT_TRIGGER` | Update Object Trigger | Update an existing custom object trigger in Zendesk. Triggers define automated actions that execute when specific conditions are met on custom object records. Use this action when you need to: - Change a trigger's title or description - Enable or disable a trigger - Modify the conditions that cause the trigger to fire - Update the actions the trigger performs This action is idempotent — re-running with the same parameters will produce the same result. |
| `ZENDESK_UPDATE_ORGANIZATION_FIELD` | Update Organization Field | Update a custom organization field in Zendesk. Use when you need to modify an existing organization field's properties such as title, type, description, options, or other settings. All existing custom_field_options must be included on update — omitted options will be deleted. Returns the updated organization field object. |
| `ZENDESK_UPDATE_ORGANIZATIONS_TAGS` | Add Organization Tags | Add organization tags in Zendesk. Use when you need to tag an organization for categorization, filtering, or automation purposes. Tags are appended to the organization's existing tags. This action is idempotent — adding the same tag multiple times will not create duplicates in the organization's tag list. |
| `ZENDESK_UPDATE_PERMISSION_POLICY` | Update Permission Policy | Update an existing permission policy for a custom object in Zendesk. Permission policies control which records of a custom object users with a specific role can access. Use this action when you need to: - Modify record access permissions (create, read, update, delete) for a custom role - Add or remove exceptions to what records users can access - Configure group-based exclusions for custom object record permissions This action is idempotent — re-running with the same parameters will produce the same result. |
| `ZENDESK_UPDATE_RESOURCE_COLLECTION` | Update Resource Collection | Update an existing resource collection in Zendesk. Resource collections are groups of related resources (like triggers, automations, or ticket fields) that can be managed together. Use this action when you need to: - Rename a resource collection - Modify the resources included in a collection - Update the configuration of an existing collection This action is idempotent - re-running with the same parameters will produce the same result. |
| `ZENDESK_UPDATE_SIDE_CONVERSATION` | Update Side Conversation | Update a side conversation on a ticket in Zendesk. Use this action to modify the state (open/closed) or subject of an existing side conversation attached to a ticket. Use when you need to: - Close a side conversation that has been resolved - Reopen a closed side conversation - Update the subject line of a side conversation This action is idempotent — re-running with the same parameters will produce the same result. |
| `ZENDESK_UPDATE_SUPPORT_ADDRESS` | Update Support Address | Update an existing support address in Zendesk. Support addresses are email addresses that receive customer inquiries and can be configured per brand. Use this action when you need to: - Change the name of a support address - Set or change the default support address for the account - Associate a support address with a different brand Note: You cannot change the email address of an existing support address. |
| `ZENDESK_UPDATE_TARGET` | Update Zendesk Target | Update an existing target in Zendesk. Targets are endpoints that receive data when triggers fire (e.g., HTTP targets, email targets, webhook targets). Use this action when you need to: - Change a target's title - Activate or deactivate a target - Update target-specific properties This action is idempotent — re-running with the same parameters will produce the same result. |
| `ZENDESK_UPDATE_TICKET_FIELD` | Update Ticket Field | Update an existing ticket field in Zendesk. Ticket fields define the structure and properties of custom fields on tickets. Use this action when you need to: - Rename a ticket field or update its title - Update the description or agent-only description - Change the field's position in the ticket form - Enable or disable a ticket field - Set visibility and editability for portal and agents - Make fields required for solving tickets or creating requests - Configure validation patterns for regexp fields - Set tags for checkbox fields This action is idempotent — re-running with the same parameters will produce the same result. Requires admin permissions. |
| `ZENDESK_UPDATE_TICKETS_TAGS` | Update Zendesk Ticket Tags | Update tags on a Zendesk ticket via PUT request to /api/v2/tickets/{ticket_id}/tags. Use when you need to add, replace, or manage tags on an existing ticket. This operation replaces all existing tags with the provided list. |
| `ZENDESK_UPDATE_TICKET_TRIGGER` | Update Ticket Trigger | Update an existing ticket trigger in Zendesk. Triggers are business rules that automatically perform actions on tickets when certain conditions are met. Use this action when you need to: - Change a trigger's title, active status, position, or description - Modify the conditions that trigger the action - Update the actions the trigger performs - Reassign a trigger to a different category - Deactivate a trigger without deleting it This action is idempotent — re-running with the same parameters will produce the same result. |
| `ZENDESK_UPDATE_TRIGGER_CATEGORY` | Update Trigger Category | Update an existing trigger category in Zendesk. Trigger categories are used to organize ticket triggers in the Zendesk admin interface. Use this action when you need to: - Rename a trigger category - Change the display order of a trigger category - Update both name and position of a trigger category This action is idempotent — re-running with the same parameters will produce the same result. |
| `ZENDESK_UPDATE_USER_FIELD` | Update Zendesk User Field | Update an existing user field in Zendesk. Use when you need to modify the title, description, options, or other properties of a custom user field. Supports updating text, checkbox, dropdown, multiselect, date, integer, decimal, regexp validation, and lookup types. Only administrators can update user fields. |
| `ZENDESK_UPDATE_USER_PROFILE` | Update Zendesk User Profile | Partially updates a user profile in Zendesk by identifier. Use when you need to modify specific fields of an existing profile without replacing the entire profile. This action uses JSON merge patch semantics — only provided fields are updated. Use this action when you have an existing profile identifier and need to update specific profile attributes, identifiers, or the profile name. The identifier must follow the format source:type:identifier_type:identifier_value. |
| `ZENDESK_UPDATE_USER_PROFILE_BY_ID` | Update Zendesk User Profile By ID | Partially updates a user profile in Zendesk by profile ID. Use when you need to modify specific fields of an existing profile without replacing the entire profile. This action uses JSON merge patch semantics — only provided fields are updated. Use this action when you have a profile ID and need to update specific profile attributes, identifiers, name, source, or type. This is different from UpdateUserProfile which uses identifier lookup instead. |
| `ZENDESK_UPDATE_USERS_IDENTITY` | Update User Identity | Update a user identity in Zendesk. Use when you need to modify an identity's verified status or other updatable fields. Note: the 'primary' field cannot be changed via this endpoint - use the Make Identity Primary endpoint instead. |
| `ZENDESK_UPDATE_USERS_ME_SETTINGS` | Update Current User Settings | Update the settings for the currently authenticated Zendesk user. Use when modifying UI preferences like keyboard shortcuts, onboarding tooltips, theme preferences, or shared views order. This action modifies the caller's own settings only. |
| `ZENDESK_UPDATE_USERS_PROFILES` | Update Users Profiles | Create or update a user profile for a specific Zendesk user by user ID and identifier. Use when you need to establish or modify a unified customer view for an existing Zendesk user. The profile is identified by both the user_id (path) and the identifier (query parameter). This endpoint uses PUT semantics - if a profile matching the identifier exists, it will be updated; otherwise, a new profile will be created. Use this action when you have a specific Zendesk user ID and need to create or update a profile using an identifier like email, phone number, or external ID. |
| `ZENDESK_UPDATE_USERS_TAGS` | Update User Tags | Update (replace) tags for a specific Zendesk user. Use when you need to assign or modify tags on a user account for organizing, filtering, or categorizing user data. This action replaces all existing tags on the user with the provided list. |
| `ZENDESK_UPDATE_VIEW` | Update View | Update an existing view in Zendesk. Views are saved searches that allow agents to filter and organize tickets. Use this action when you need to: - Change a view's title, description, or active status - Modify a view's position in the list - Update a view's conditions or display settings - Make a view the default view This action is idempotent — re-running with the same parameters will produce the same result. |
| `ZENDESK_UPDATE_ZENDESK_ACCOUNT_SETTINGS` | Update Zendesk Account Settings | Update Zendesk account-level settings including tickets, branding, localization, routing, and more. Use when you need to configure or modify account-wide settings that affect all agents and end users. Requires admin privileges to update most settings. Settings changes are persistent and affect all users. |
| `ZENDESK_UPDATE_ZENDESK_ATTACHMENT` | Update Zendesk Attachment | Updates an attachment's malware access override setting. Use when you need to enable or restrict agent access to attachments that have been flagged for malware. |
| `ZENDESK_UPDATE_ZENDESK_CUSTOM_OBJECT_FIELD` | Update Custom Object Field | Update an existing custom object field in Zendesk. Custom object fields define the structure and properties of data within a custom object. Use this action when you need to: - Rename a custom object field - Update the description or display properties - Change the field's position in the UI - Enable or disable a field - Set validation patterns or make fields required This action is idempotent — re-running with the same parameters will produce the same result. |
| `ZENDESK_UPDATE_ZENDESK_DYNAMIC_CONTENT_ITEM` | Update Dynamic Content Item | Update a dynamic content item in Zendesk. The only attribute that can be changed is the name. Use when you need to rename an existing dynamic content item after confirming its ID. Note: Dynamic content items are used to store multilingual content for use in triggers, automations, and macros. Updating the name affects all references to this item. |
| `ZENDESK_UPDATE_ZENDESK_ORGANIZATION` | Update Zendesk Organization | Update an organization in Zendesk. After updating, re-fetch via ZENDESK_GET_ZENDESK_ORGANIZATION if downstream logic depends on current data. |
| `ZENDESK_UPDATE_ZENDESK_REQUESTS` | Update Request | Update a ticket request in Zendesk with a comment or collaborators. Use when you need to modify request fields like status, priority, or add comments after confirming the request ID. After updating, re-fetch via ZENDESK_GET_REQUESTS if downstream logic depends on current data. |
| `ZENDESK_UPDATE_ZENDESK_TICKET` | Update Zendesk Ticket | Tool to update a ticket in Zendesk. Use when you need to modify ticket fields like status, priority, or subject after confirming the ticket ID. |
| `ZENDESK_UPSERT_CUSTOM_OBJECT_RECORD_BY_EXTERNAL_ID_OR_NAME` | Upsert Custom Object Record By External ID or Name | Create or update a custom object record in Zendesk by external_id or name. Use when you need to create a new record or update an existing one based on either its external_id (preferred) or name. If a record matching the external_id or name exists, it will be updated. If no matching record is found, a new one will be created. This action is idempotent and safe to retry. Note: Either external_id or name (or both) must be provided to identify the record. If both are provided, external_id takes precedence for matching. |
| `ZENDESK_VERIFY_SUBDOMAIN_AVAILABILITY` | Verify Subdomain Availability | Verify if a subdomain name is available for use in Zendesk. Returns a success boolean indicating whether the subdomain can be registered. Use when checking if a desired subdomain name is available before creating a new Zendesk account or subdomain. |
| `ZENDESK_VERIFY_SUPPORT_ADDRESS` | Verify Support Address | Verify a support address forwarding in Zendesk. This action sends a verification request for the specified support address to confirm that the address is properly configured and can receive email forwarding. Use this action when you need to: - Verify a newly created support address is working correctly - Re-verify an existing support address after configuration changes - Confirm email forwarding is properly set up for a support address This action is idempotent — verifying an already-verified address will return success. |
| `ZENDESK_VERIFY_USER_IDENTITY` | Verify User Identity | Set a user identity as verified in Zendesk. This action marks an email address or other identity as confirmed, indicating the user has proven ownership. Use when you need to manually verify a user's identity after they have completed an out-of-band verification process or when you want to override the verification status for administrative purposes. Note: This action cannot verify the account owner's email identity due to security restrictions. |

## Supported Triggers

| Trigger slug | Name | Description |
|---|---|---|
| `ZENDESK_NEW_USER_TRIGGER` | New User Created | Triggered when a new user is created in Zendesk. |
| `ZENDESK_NEW_ZENDESK_TICKET_TRIGGER` | New Zendesk Ticket | Triggers when a new ticket is created in a specified Zendesk view. |

## Creating MCP Server - Stand-alone vs Composio SDK

The Zendesk MCP server is an implementation of the Model Context Protocol that connects your AI agent to Zendesk. It provides structured and secure access so your agent can perform Zendesk operations on your behalf through a secure, permission-based interface.
With Composio's managed implementation, you don't have to create your own developer app. For production, if you're building an end product, we recommend using your own credentials. The managed server helps you prototype fast and go from 0-1 faster.

## Step-by-step Guide

### 1. Prerequisites

Before starting, make sure you have:
- Python 3.9 or higher
- A Composio account with an active API key
- Basic familiarity with Python and async programming

### 1. Getting API Keys for OpenAI and Composio

OpenAI API Key
- Go to the [OpenAI dashboard](https://platform.openai.com/settings/organization/api-keys) and create an API key. You'll need credits to use the models, or you can connect to another model provider.
- Keep the API key safe.
Composio API Key
- Log in to the [Composio dashboard](https://dashboard.composio.dev?utm_source=toolkits&utm_medium=framework_docs).
- Navigate to your API settings and generate a new API key.
- Store this key securely as you'll need it for authentication.

### 2. Install dependencies

Install the required libraries.
What's happening:
- composio connects your agent to external SaaS tools like Zendesk
- pydantic-ai lets you create structured AI agents with tool support
- python-dotenv loads your environment variables securely from a .env file
```bash
pip install composio pydantic-ai python-dotenv
```

### 3. Set up environment variables

Create a .env file in your project root.
What's happening:
- COMPOSIO_API_KEY authenticates your agent to Composio's API
- USER_ID associates your session with your account for secure tool access
- OPENAI_API_KEY to access OpenAI LLMs
```bash
COMPOSIO_API_KEY=your_composio_api_key_here
USER_ID=your_user_id_here
OPENAI_API_KEY=your_openai_api_key
```

### 4. Import dependencies

What's happening:
- We load environment variables and import required modules
- Composio manages connections to Zendesk
- MCPServerStreamableHTTP connects to the Zendesk MCP server endpoint
- Agent from Pydantic AI lets you define and run the AI assistant
```python
import asyncio
import os
from dotenv import load_dotenv
from composio import Composio
from pydantic_ai import Agent
from pydantic_ai.mcp import MCPServerStreamableHTTP

load_dotenv()
```

### 5. Create a Tool Router Session

What's happening:
- We're creating a Tool Router session that gives your agent access to Zendesk tools
- The create method takes the user ID and specifies which toolkits should be available
- The returned session.mcp.url is the MCP server URL that your agent will use
```python
async def main():
    api_key = os.getenv("COMPOSIO_API_KEY")
    user_id = os.getenv("USER_ID")
    if not api_key or not user_id:
        raise RuntimeError("Set COMPOSIO_API_KEY and USER_ID in your environment")

    # Create a Composio Tool Router session for Zendesk
    composio = Composio(api_key=api_key)
    session = composio.create(
        user_id=user_id,
        toolkits=["zendesk"],
    )
    url = session.mcp.url
    if not url:
        raise ValueError("Composio session did not return an MCP URL")
```

### 6. Initialize the Pydantic AI Agent

What's happening:
- The MCP client connects to the Zendesk endpoint
- The agent uses GPT-5 to interpret user commands and perform Zendesk operations
- The instructions field defines the agent's role and behavior
```python
# Attach the MCP server to a Pydantic AI Agent
zendesk_mcp = MCPServerStreamableHTTP(url, headers={"x-api-key": COMPOSIO_API_KEY})
agent = Agent(
    "openai:gpt-5",
    toolsets=[zendesk_mcp],
    instructions=(
        "You are a Zendesk assistant. Use Zendesk tools to help users "
        "with their requests. Ask clarifying questions when needed."
    ),
)
```

### 7. Build the chat interface

What's happening:
- The agent reads input from the terminal and streams its response
- Zendesk API calls happen automatically under the hood
- The model keeps conversation history to maintain context across turns
```python
# Simple REPL with message history
history = []
print("Chat started! Type 'exit' or 'quit' to end.\n")
print("Try asking the agent to help you with Zendesk.\n")

while True:
    user_input = input("You: ").strip()
    if user_input.lower() in {"exit", "quit", "bye"}:
        print("\nGoodbye!")
        break
    if not user_input:
        continue

    print("\nAgent is thinking...\n", flush=True)

    async with agent.run_stream(user_input, message_history=history) as stream_result:
        collected_text = ""
        async for chunk in stream_result.stream_output():
            text_piece = None
            if isinstance(chunk, str):
                text_piece = chunk
            elif hasattr(chunk, "delta") and isinstance(chunk.delta, str):
                text_piece = chunk.delta
            elif hasattr(chunk, "text"):
                text_piece = chunk.text
            if text_piece:
                collected_text += text_piece
        result = stream_result

    print(f"Agent: {collected_text}\n")
    history = result.all_messages()
```

### 8. Run the application

What's happening:
- The asyncio loop launches the agent and keeps it running until you exit
```python
if __name__ == "__main__":
    asyncio.run(main())
```

## Complete Code

```python
import asyncio
import os
from dotenv import load_dotenv
from composio import Composio
from pydantic_ai import Agent
from pydantic_ai.mcp import MCPServerStreamableHTTP

load_dotenv()

async def main():
    api_key = os.getenv("COMPOSIO_API_KEY")
    user_id = os.getenv("USER_ID")
    if not api_key or not user_id:
        raise RuntimeError("Set COMPOSIO_API_KEY and USER_ID in your environment")

    # Create a Composio Tool Router session for Zendesk
    composio = Composio(api_key=api_key)
    session = composio.create(
        user_id=user_id,
        toolkits=["zendesk"],
    )
    url = session.mcp.url
    if not url:
        raise ValueError("Composio session did not return an MCP URL")

    # Attach the MCP server to a Pydantic AI Agent
    zendesk_mcp = MCPServerStreamableHTTP(url, headers={"x-api-key": COMPOSIO_API_KEY})
    agent = Agent(
        "openai:gpt-5",
        toolsets=[zendesk_mcp],
        instructions=(
            "You are a Zendesk assistant. Use Zendesk tools to help users "
            "with their requests. Ask clarifying questions when needed."
        ),
    )

    # Simple REPL with message history
    history = []
    print("Chat started! Type 'exit' or 'quit' to end.\n")
    print("Try asking the agent to help you with Zendesk.\n")

    while True:
        user_input = input("You: ").strip()
        if user_input.lower() in {"exit", "quit", "bye"}:
            print("\nGoodbye!")
            break
        if not user_input:
            continue

        print("\nAgent is thinking...\n", flush=True)

        async with agent.run_stream(user_input, message_history=history) as stream_result:
            collected_text = ""
            async for chunk in stream_result.stream_output():
                text_piece = None
                if isinstance(chunk, str):
                    text_piece = chunk
                elif hasattr(chunk, "delta") and isinstance(chunk.delta, str):
                    text_piece = chunk.delta
                elif hasattr(chunk, "text"):
                    text_piece = chunk.text
                if text_piece:
                    collected_text += text_piece
            result = stream_result

        print(f"Agent: {collected_text}\n")
        history = result.all_messages()

if __name__ == "__main__":
    asyncio.run(main())
```

## Conclusion

You've built a Pydantic AI agent that can interact with Zendesk through Composio's Tool Router. With this setup, your agent can perform real Zendesk actions through natural language.
You can extend this further by:
- Adding other toolkits like Gmail, HubSpot, or Salesforce
- Building a web-based chat interface around this agent
- Using multiple MCP endpoints to enable cross-app workflows (for example, Gmail + Zendesk for workflow automation)
This architecture makes your AI agent "agent-native", able to securely use APIs in a unified, composable way without custom integrations.

## How to build Zendesk MCP Agent with another framework

- [ChatGPT](https://composio.dev/toolkits/zendesk/framework/chatgpt)
- [OpenAI Agents SDK](https://composio.dev/toolkits/zendesk/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/zendesk/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/zendesk/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/zendesk/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/zendesk/framework/codex)
- [Cursor](https://composio.dev/toolkits/zendesk/framework/cursor)
- [VS Code](https://composio.dev/toolkits/zendesk/framework/vscode)
- [OpenCode](https://composio.dev/toolkits/zendesk/framework/opencode)
- [OpenClaw](https://composio.dev/toolkits/zendesk/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/zendesk/framework/hermes-agent)
- [CLI](https://composio.dev/toolkits/zendesk/framework/cli)
- [Google ADK](https://composio.dev/toolkits/zendesk/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/zendesk/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/zendesk/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/zendesk/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/zendesk/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/zendesk/framework/crew-ai)

## Related Toolkits

- [Aeroleads](https://composio.dev/toolkits/aeroleads) - Aeroleads is a B2B lead generation platform for finding business emails and phone numbers. Grow your sales pipeline faster with powerful prospecting tools.
- [Autobound](https://composio.dev/toolkits/autobound) - Autobound is an AI-powered sales engagement platform that crafts hyper-personalized outreach and insights. It helps sales teams boost response rates and close more deals through tailored content and recommendations.
- [Better proposals](https://composio.dev/toolkits/better_proposals) - Better Proposals is a web-based tool for crafting and sending professional proposals. It helps teams impress clients and close deals faster with slick, easy-to-use templates.
- [Bidsketch](https://composio.dev/toolkits/bidsketch) - Bidsketch is a proposal software that helps businesses create professional proposals quickly and efficiently. It streamlines the proposal process, saving time while boosting client win rates.
- [Bolna](https://composio.dev/toolkits/bolna) - Bolna is an AI platform for building conversational voice agents. It helps businesses automate support and streamline interactions through natural, voice-powered conversations.
- [Botsonic](https://composio.dev/toolkits/botsonic) - Botsonic is a no-code AI chatbot builder for easily creating and deploying chatbots to your website. It empowers businesses to offer conversational experiences without writing code.
- [Botstar](https://composio.dev/toolkits/botstar) - BotStar is a comprehensive chatbot platform for designing, developing, and training chatbots visually on Messenger and websites. It helps businesses automate conversations and customer interactions without coding.
- [Callerapi](https://composio.dev/toolkits/callerapi) - CallerAPI is a white-label caller identification platform for branded caller ID and fraud prevention. It helps businesses boost customer trust while stopping spam, fraud, and robocalls.
- [Callingly](https://composio.dev/toolkits/callingly) - Callingly is a lead response management platform that automates immediate call and text follow-ups with new leads. It helps sales teams boost response speed and close more deals by connecting seamlessly with CRMs and lead sources.
- [Callpage](https://composio.dev/toolkits/callpage) - Callpage is a lead capture platform that lets businesses instantly connect with website visitors via callback. It boosts lead generation and increases your sales conversion rates.
- [Clearout](https://composio.dev/toolkits/clearout) - Clearout is an AI-powered service for verifying, finding, and enriching email addresses. It boosts deliverability and helps you discover high-quality leads effortlessly.
- [Clientary](https://composio.dev/toolkits/clientary) - Clientary is a platform for managing clients, invoices, projects, proposals, and more. It streamlines client work and saves you serious admin time.
- [Convolo ai](https://composio.dev/toolkits/convolo_ai) - Convolo ai is an AI-powered communications platform for sales teams. It accelerates lead response and improves conversion rates by automating calls and integrating workflows.
- [Delighted](https://composio.dev/toolkits/delighted) - Delighted is a customer feedback platform based on the Net Promoter System®. It helps you quickly gather, track, and act on customer sentiment.
- [Emelia](https://composio.dev/toolkits/emelia) - Emelia is an all-in-one B2B prospecting platform for cold-email, LinkedIn outreach, and prospect research. It streamlines outbound campaigns so you can find, engage, and warm up leads faster.
- [Findymail](https://composio.dev/toolkits/findymail) - Findymail is a B2B data provider offering verified email and phone contacts for sales prospecting. Enhance outreach with automated exports, email verification, and CRM enrichment.
- [Freshdesk](https://composio.dev/toolkits/freshdesk) - Freshdesk is customer support software with ticketing and automation tools. It helps teams streamline helpdesk operations for faster, better customer support.
- [Fullenrich](https://composio.dev/toolkits/fullenrich) - FullEnrich is a B2B contact enrichment platform that aggregates emails and phone numbers from 15+ data vendors. Instantly find and verify lead contact data to boost your outreach.
- [Gatherup](https://composio.dev/toolkits/gatherup) - GatherUp is a customer feedback and online review management platform. It helps businesses boost their reputation by streamlining how they collect and manage customer feedback.
- [Getprospect](https://composio.dev/toolkits/getprospect) - Getprospect is a business email discovery tool with LinkedIn integration. Use it to quickly find and verify professional email addresses.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and Zendesk MCP?

With a standalone Zendesk MCP server, the agents and LLMs can only access a fixed set of Zendesk tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Zendesk and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Pydantic AI?

Yes, you can. Pydantic AI fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Zendesk tools.

### Can I manage the permissions and scopes for Zendesk while using Tool Router?

Yes, absolutely. You can configure which Zendesk scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Zendesk data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)