Zendesk

Zendesk MCP Server for Cloudflare Workers

Available Tools

82 tools available in the Zendesk MCP server. Each tool can be called by AI assistants to perform specific actions.

zendesk_list_active_automations

List only active automations.

Args:

format: Response format ('json' or 'markdown')

Returns: List of active automations.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

zendesk_get_group

Get a single group by ID.

Args:

groupId: The group ID
format: Response format

Returns: The group record with all available fields.

{
  "type": "object",
  "required": [
    "groupId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "groupId": {
      "type": "integer",
      "description": "Group ID"
    }
  }
}

zendesk_list_ticket_audits

List audit events for a ticket (change history).

Args:

ticketId: The ticket ID
page: Page number
perPage: Audits per page
format: Response format

Returns: Paginated list of audit events showing ticket changes.

{
  "type": "object",
  "required": [
    "ticketId"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "ticketId": {
      "type": "integer",
      "description": "Ticket ID"
    }
  }
}

zendesk_get_automation

Get a single automation by ID.

Args:

automationId: The automation ID
format: Response format

Returns: The automation record with conditions and actions.

{
  "type": "object",
  "required": [
    "automationId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "automationId": {
      "type": "integer",
      "description": "Automation ID"
    }
  }
}

zendesk_list_groups

List groups from Zendesk with pagination.

Args:

page: Page number (default: 1)
perPage: Groups per page (1-100, default: 20)
format: Response format ('json' or 'markdown')

Returns: Paginated list of groups.

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    }
  }
}

zendesk_list_automations

List all automations in the account.

Args:

page: Page number (default: 1)
perPage: Automations per page (1-100, default: 20)
format: Response format ('json' or 'markdown')

Returns: Paginated list of automations.

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    }
  }
}

zendesk_search_automations

Search for automations by title.

Args:

query: Search query for automation title
format: Response format

Returns: List of matching automations.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

zendesk_list_brands

List all brands in the account.

Args:

format: Response format ('json' or 'markdown')

Returns: List of brands.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

zendesk_get_brand

Get a single brand by ID.

Args:

brandId: The brand ID
format: Response format

Returns: The brand record.

{
  "type": "object",
  "required": [
    "brandId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "brandId": {
      "type": "integer",
      "description": "Brand ID"
    }
  }
}

zendesk_list_ticket_comments

List comments on a ticket.

Args:

ticketId: The ticket ID
page: Page number
perPage: Comments per page
format: Response format ('json' or 'markdown')

Returns: Paginated list of comments with body, author, public/private status.

{
  "type": "object",
  "required": [
    "ticketId"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "ticketId": {
      "type": "integer",
      "description": "Ticket ID"
    }
  }
}

zendesk_add_ticket_comment

Add a comment to a ticket.

Args:

ticketId: The ticket ID
body: Comment body text
isPublic: Whether the comment is public (true) or internal note (false)
authorId: Author user ID (optional, defaults to authenticated user)

Returns: The updated ticket record.

{
  "type": "object",
  "required": [
    "ticketId",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Comment body"
    },
    "authorId": {
      "type": "integer",
      "description": "Author user ID"
    },
    "isPublic": {
      "type": "boolean",
      "default": true,
      "description": "Public comment or internal note"
    },
    "ticketId": {
      "type": "integer",
      "description": "Ticket ID"
    }
  }
}

zendesk_make_comment_private

Convert a public comment to a private internal note.

Args:

ticketId: The ticket ID
commentId: The comment ID

Returns: Confirmation of the change.

{
  "type": "object",
  "required": [
    "ticketId",
    "commentId"
  ],
  "properties": {
    "ticketId": {
      "type": "integer",
      "description": "Ticket ID"
    },
    "commentId": {
      "type": "integer",
      "description": "Comment ID"
    }
  }
}

zendesk_list_assignable_groups

List groups that can be assigned tickets.

Args:

format: Response format ('json' or 'markdown')

Returns: List of assignable groups.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

zendesk_create_group

Create a new group in Zendesk.

Args:

name: Group name (required)
description: Group description

Returns: The created group record.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Group name"
    },
    "description": {
      "type": "string",
      "description": "Group description"
    }
  }
}

zendesk_update_group

Update an existing group.

Args:

groupId: Group ID to update
name: New group name
description: New group description

Returns: The updated group record.

{
  "type": "object",
  "required": [
    "groupId"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "groupId": {
      "type": "integer",
      "description": "Group ID to update"
    },
    "description": {
      "type": "string"
    }
  }
}

zendesk_delete_group

Delete a group from Zendesk.

Args:

groupId: Group ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "groupId"
  ],
  "properties": {
    "groupId": {
      "type": "integer",
      "description": "Group ID to delete"
    }
  }
}

zendesk_list_user_groups

List groups that a specific user belongs to.

Args:

userId: User ID
format: Response format

Returns: List of groups the user belongs to.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "userId": {
      "type": "integer",
      "description": "User ID"
    }
  }
}

zendesk_list_macros

List all macros available to the current user.

Args:

page: Page number (default: 1)
perPage: Macros per page (1-100, default: 20)
format: Response format ('json' or 'markdown')

Returns: Paginated list of macros.

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    }
  }
}

zendesk_list_active_macros

List only active macros.

Args:

format: Response format ('json' or 'markdown')

Returns: List of active macros.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

zendesk_get_macro

Get a single macro by ID.

Args:

macroId: The macro ID
format: Response format

Returns: The macro record with all actions.

{
  "type": "object",
  "required": [
    "macroId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "macroId": {
      "type": "integer",
      "description": "Macro ID"
    }
  }
}

zendesk_apply_macro

Apply a macro to a ticket.

Args:

ticketId: The ticket ID
macroId: The macro ID

Returns: The changes the macro would make to the ticket.

{
  "type": "object",
  "required": [
    "ticketId",
    "macroId"
  ],
  "properties": {
    "macroId": {
      "type": "integer",
      "description": "Macro ID"
    },
    "ticketId": {
      "type": "integer",
      "description": "Ticket ID"
    }
  }
}

zendesk_search_macros

Search for macros by title.

Args:

query: Search query for macro title
format: Response format

Returns: List of matching macros.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

zendesk_list_organizations

List organizations from Zendesk with pagination.

Args:

page: Page number (default: 1)
perPage: Organizations per page (1-100, default: 20)
format: Response format ('json' or 'markdown')

Returns: Paginated list of organizations.

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    }
  }
}

zendesk_get_organization

Get a single organization by ID.

Args:

organizationId: The organization ID
format: Response format

Returns: The organization record with all available fields.

{
  "type": "object",
  "required": [
    "organizationId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "organizationId": {
      "type": "integer",
      "description": "Organization ID"
    }
  }
}

zendesk_create_organization

Create a new organization in Zendesk.

Args:

name: Organization name (required)
domainNames: Array of domain names
details: Details about the organization
notes: Notes about the organization
groupId: Default group ID
sharedTickets: Allow users to see each other's tickets
sharedComments: Allow users to see each other's comments
externalId: External ID for integrations
tags: Array of tags

Returns: The created organization record.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Organization name"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tags"
    },
    "notes": {
      "type": "string",
      "description": "Notes"
    },
    "details": {
      "type": "string",
      "description": "Details"
    },
    "groupId": {
      "type": "integer",
      "description": "Default group ID"
    },
    "externalId": {
      "type": "string",
      "description": "External ID"
    },
    "domainNames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Domain names"
    },
    "sharedTickets": {
      "type": "boolean",
      "description": "Share tickets"
    },
    "sharedComments": {
      "type": "boolean",
      "description": "Share comments"
    }
  }
}

zendesk_update_organization

Update an existing organization.

Args:

organizationId: Organization ID to update
name: New name
domainNames: New domain names
details: New details
notes: New notes
groupId: New default group ID
sharedTickets: Enable/disable shared tickets
sharedComments: Enable/disable shared comments
tags: Replace tags

Returns: The updated organization record.

{
  "type": "object",
  "required": [
    "organizationId"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "notes": {
      "type": "string"
    },
    "details": {
      "type": "string"
    },
    "groupId": {
      "type": "integer"
    },
    "domainNames": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "sharedTickets": {
      "type": "boolean"
    },
    "organizationId": {
      "type": "integer",
      "description": "Organization ID to update"
    },
    "sharedComments": {
      "type": "boolean"
    }
  }
}

zendesk_delete_organization

Delete an organization from Zendesk.

Args:

organizationId: Organization ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "organizationId"
  ],
  "properties": {
    "organizationId": {
      "type": "integer",
      "description": "Organization ID to delete"
    }
  }
}

zendesk_search_organizations

Search for organizations by name or external ID.

Args:

query: Search query
format: Response format

Returns: List of matching organizations.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

zendesk_autocomplete_organizations

Autocomplete organization names.

Args:

name: Organization name prefix

Returns: List of matching organizations.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Organization name prefix"
    }
  }
}

zendesk_list_satisfaction_ratings

List satisfaction ratings from Zendesk.

Args:

page: Page number (default: 1)
perPage: Ratings per page (1-100, default: 20)
format: Response format ('json' or 'markdown')

Returns: Paginated list of satisfaction ratings.

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    }
  }
}

zendesk_get_satisfaction_rating

Get a single satisfaction rating by ID.

Args:

ratingId: The satisfaction rating ID
format: Response format

Returns: The satisfaction rating record.

{
  "type": "object",
  "required": [
    "ratingId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "ratingId": {
      "type": "integer",
      "description": "Satisfaction rating ID"
    }
  }
}

zendesk_create_satisfaction_rating

Create a satisfaction rating for a solved or reopened ticket.

Args:

ticketId: The ticket ID
score: Rating score ('good' or 'bad')
comment: Optional comment

Returns: The created satisfaction rating.

{
  "type": "object",
  "required": [
    "ticketId",
    "score"
  ],
  "properties": {
    "score": {
      "enum": [
        "good",
        "bad"
      ],
      "type": "string",
      "description": "Rating score"
    },
    "comment": {
      "type": "string",
      "description": "Optional comment"
    },
    "ticketId": {
      "type": "integer",
      "description": "Ticket ID"
    }
  }
}

zendesk_list_tickets

List tickets from Zendesk with pagination.

Args:

page: Page number (default: 1)
perPage: Number of tickets per page (1-100, default: 20)
sortBy: Sort field (created_at, updated_at, priority, status, ticket_type)
sortOrder: Sort direction ('asc' or 'desc')
format: Response format ('json' or 'markdown')

Returns: Paginated list of tickets with id, subject, status, priority, requester, assignee.

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "sortBy": {
      "type": "string",
      "description": "Sort field"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Tickets per page"
    },
    "sortOrder": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Sort direction"
    }
  }
}

zendesk_search

Search Zendesk for tickets, users, organizations, or groups.

Args:

query: Search query string (supports Zendesk search syntax)
type: Filter by type (ticket, user, organization, group)
sortBy: Sort field (created_at, updated_at, priority, status, ticket_type)
sortOrder: Sort direction ('asc' or 'desc')
page: Page number (default: 1)
perPage: Results per page (1-100, default: 20)
format: Response format ('json' or 'markdown')

Examples:

"status:open" - Find open tickets
"type:ticket status:pending" - Find pending tickets
"assignee:me" - Find tickets assigned to current user
"requester:john@example.com" - Find tickets from a specific requester
"tags:urgent priority:high" - Find high priority urgent tickets
"created>2024-01-01" - Find items created after a date

Returns: Search results with count and pagination.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "type": {
      "enum": [
        "ticket",
        "user",
        "organization",
        "group"
      ],
      "type": "string",
      "description": "Filter by type"
    },
    "query": {
      "type": "string",
      "description": "Search query (supports Zendesk search syntax)"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "sortBy": {
      "type": "string",
      "description": "Sort field"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "sortOrder": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Sort direction"
    }
  }
}

zendesk_search_count

Get the count of items matching a search query.

Args:

query: Search query string

Returns: Count of matching items.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    }
  }
}

zendesk_list_suspended_tickets

List suspended tickets from Zendesk.

Args:

page: Page number (default: 1)
perPage: Tickets per page (1-100, default: 20)
format: Response format ('json' or 'markdown')

Returns: Paginated list of suspended tickets.

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    }
  }
}

zendesk_get_suspended_ticket

Get a single suspended ticket by ID.

Args:

ticketId: The suspended ticket ID
format: Response format

Returns: The suspended ticket record.

{
  "type": "object",
  "required": [
    "ticketId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "ticketId": {
      "type": "integer",
      "description": "Suspended ticket ID"
    }
  }
}

zendesk_recover_suspended_ticket

Recover a suspended ticket (convert to regular ticket).

Args:

ticketId: The suspended ticket ID

Returns: The recovered ticket record.

{
  "type": "object",
  "required": [
    "ticketId"
  ],
  "properties": {
    "ticketId": {
      "type": "integer",
      "description": "Suspended ticket ID"
    }
  }
}

zendesk_delete_suspended_ticket

Delete a suspended ticket.

Args:

ticketId: The suspended ticket ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "ticketId"
  ],
  "properties": {
    "ticketId": {
      "type": "integer",
      "description": "Suspended ticket ID"
    }
  }
}

zendesk_list_tags

List all tags in the account.

Args:

format: Response format ('json' or 'markdown')

Returns: List of tags with their usage counts.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

zendesk_autocomplete_tags

Search for tags by name prefix.

Args:

name: Tag name prefix (minimum 2 characters)

Returns: Array of matching tag names.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Tag name prefix"
    }
  }
}

zendesk_list_ticket_tags

List tags on a specific ticket.

Args:

ticketId: The ticket ID

Returns: Array of tag names on the ticket.

{
  "type": "object",
  "required": [
    "ticketId"
  ],
  "properties": {
    "ticketId": {
      "type": "integer",
      "description": "Ticket ID"
    }
  }
}

zendesk_add_ticket_tags

Add tags to a ticket (keeps existing tags).

Args:

ticketId: The ticket ID
tags: Array of tags to add

Returns: Updated array of all tags on the ticket.

{
  "type": "object",
  "required": [
    "ticketId",
    "tags"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tags to add"
    },
    "ticketId": {
      "type": "integer",
      "description": "Ticket ID"
    }
  }
}

zendesk_set_ticket_tags

Replace all tags on a ticket.

Args:

ticketId: The ticket ID
tags: Array of tags (replaces all existing)

Returns: Updated array of tags on the ticket.

{
  "type": "object",
  "required": [
    "ticketId",
    "tags"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tags to set (replaces existing)"
    },
    "ticketId": {
      "type": "integer",
      "description": "Ticket ID"
    }
  }
}

zendesk_remove_ticket_tags

Remove specific tags from a ticket.

Args:

ticketId: The ticket ID
tags: Array of tags to remove

Returns: Updated array of remaining tags on the ticket.

{
  "type": "object",
  "required": [
    "ticketId",
    "tags"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tags to remove"
    },
    "ticketId": {
      "type": "integer",
      "description": "Ticket ID"
    }
  }
}

zendesk_list_ticket_fields

List all system and custom ticket fields.

Args:

format: Response format ('json' or 'markdown')

Returns: List of ticket fields with type, title, and options.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

zendesk_get_ticket_field

Get a single ticket field by ID.

Args:

fieldId: The ticket field ID
format: Response format

Returns: The ticket field record with all options.

{
  "type": "object",
  "required": [
    "fieldId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "fieldId": {
      "type": "integer",
      "description": "Ticket field ID"
    }
  }
}

zendesk_get_ticket

Get a single ticket by ID.

Args:

ticketId: The ticket ID
format: Response format ('json' or 'markdown')

Returns: The ticket record with all available fields.

{
  "type": "object",
  "required": [
    "ticketId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "ticketId": {
      "type": "integer",
      "description": "Ticket ID"
    }
  }
}

zendesk_get_tickets_by_ids

Get multiple tickets by their IDs.

Args:

ticketIds: Array of ticket IDs (up to 100)
format: Response format ('json' or 'markdown')

Returns: Array of ticket records.

{
  "type": "object",
  "required": [
    "ticketIds"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "ticketIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Array of ticket IDs"
    }
  }
}

zendesk_create_ticket

Create a new ticket in Zendesk.

Args:

subject: Ticket subject (required)
description: Ticket description/first comment (required)
priority: Priority (low, normal, high, urgent)
status: Status (new, open, pending, hold, solved)
type: Ticket type (problem, incident, question, task)
requesterId: Requester user ID
assigneeId: Assignee user ID
groupId: Group ID
organizationId: Organization ID
tags: Array of tags
externalId: External ID for integrations
isPublic: Whether comment is public (default: true)

Returns: The created ticket record.

{
  "type": "object",
  "required": [
    "subject",
    "description"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tags"
    },
    "type": {
      "enum": [
        "problem",
        "incident",
        "question",
        "task"
      ],
      "type": "string",
      "description": "Ticket type"
    },
    "status": {
      "enum": [
        "new",
        "open",
        "pending",
        "hold",
        "solved"
      ],
      "type": "string",
      "description": "Status"
    },
    "groupId": {
      "type": "integer",
      "description": "Group ID"
    },
    "subject": {
      "type": "string",
      "description": "Ticket subject"
    },
    "isPublic": {
      "type": "boolean",
      "default": true,
      "description": "Whether comment is public"
    },
    "priority": {
      "enum": [
        "low",
        "normal",
        "high",
        "urgent"
      ],
      "type": "string",
      "description": "Priority"
    },
    "assigneeId": {
      "type": "integer",
      "description": "Assignee user ID"
    },
    "externalId": {
      "type": "string",
      "description": "External ID"
    },
    "description": {
      "type": "string",
      "description": "Ticket description"
    },
    "requesterId": {
      "type": "integer",
      "description": "Requester user ID"
    },
    "organizationId": {
      "type": "integer",
      "description": "Organization ID"
    }
  }
}

zendesk_update_ticket

Update an existing ticket.

Args:

ticketId: Ticket ID to update
subject: New subject
status: New status (new, open, pending, hold, solved, closed)
priority: New priority (low, normal, high, urgent)
type: New type (problem, incident, question, task)
assigneeId: New assignee user ID
groupId: New group ID
tags: Replace tags with new array
comment: Add a comment when updating
isPublic: Whether the comment is public (default: true)

Returns: The updated ticket record.

{
  "type": "object",
  "required": [
    "ticketId"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Replace tags"
    },
    "type": {
      "enum": [
        "problem",
        "incident",
        "question",
        "task"
      ],
      "type": "string",
      "description": "New type"
    },
    "status": {
      "enum": [
        "new",
        "open",
        "pending",
        "hold",
        "solved",
        "closed"
      ],
      "type": "string",
      "description": "New status"
    },
    "comment": {
      "type": "string",
      "description": "Add a comment"
    },
    "groupId": {
      "type": "integer",
      "description": "New group ID"
    },
    "subject": {
      "type": "string",
      "description": "New subject"
    },
    "isPublic": {
      "type": "boolean",
      "default": true,
      "description": "Whether comment is public"
    },
    "priority": {
      "enum": [
        "low",
        "normal",
        "high",
        "urgent"
      ],
      "type": "string",
      "description": "New priority"
    },
    "ticketId": {
      "type": "integer",
      "description": "Ticket ID to update"
    },
    "assigneeId": {
      "type": "integer",
      "description": "New assignee user ID"
    }
  }
}

zendesk_delete_ticket

Delete a ticket from Zendesk.

Args:

ticketId: Ticket ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "ticketId"
  ],
  "properties": {
    "ticketId": {
      "type": "integer",
      "description": "Ticket ID to delete"
    }
  }
}

zendesk_list_recent_tickets

List recently viewed tickets.

Args:

format: Response format ('json' or 'markdown')

Returns: List of recently viewed tickets.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

zendesk_list_user_requested_tickets

List tickets requested by a specific user.

Args:

userId: User ID
page: Page number
perPage: Tickets per page
format: Response format

Returns: Paginated list of tickets requested by the user.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "userId": {
      "type": "integer",
      "description": "User ID"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    }
  }
}

zendesk_list_user_assigned_tickets

List tickets assigned to a specific user.

Args:

userId: User ID
page: Page number
perPage: Tickets per page
format: Response format

Returns: Paginated list of tickets assigned to the user.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "userId": {
      "type": "integer",
      "description": "User ID"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    }
  }
}

zendesk_list_organization_tickets

List tickets for a specific organization.

Args:

organizationId: Organization ID
page: Page number
perPage: Tickets per page
format: Response format

Returns: Paginated list of tickets for the organization.

{
  "type": "object",
  "required": [
    "organizationId"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "organizationId": {
      "type": "integer",
      "description": "Organization ID"
    }
  }
}

zendesk_merge_tickets

Merge multiple tickets into a target ticket.

Args:

targetTicketId: ID of the ticket to merge into
sourceTicketIds: Array of ticket IDs to merge from
targetComment: Comment to add to the target ticket
sourceComment: Comment to add to the source tickets

Returns: Job status for the merge operation.

{
  "type": "object",
  "required": [
    "targetTicketId",
    "sourceTicketIds"
  ],
  "properties": {
    "sourceComment": {
      "type": "string",
      "description": "Comment for source tickets"
    },
    "targetComment": {
      "type": "string",
      "description": "Comment for target ticket"
    },
    "targetTicketId": {
      "type": "integer",
      "description": "Target ticket ID"
    },
    "sourceTicketIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Source ticket IDs"
    }
  }
}

zendesk_mark_ticket_as_spam

Mark a ticket as spam and suspend the requester.

Args:

ticketId: Ticket ID to mark as spam

Returns: Confirmation of spam marking.

{
  "type": "object",
  "required": [
    "ticketId"
  ],
  "properties": {
    "ticketId": {
      "type": "integer",
      "description": "Ticket ID"
    }
  }
}

zendesk_list_triggers

List all triggers in the account.

Args:

page: Page number (default: 1)
perPage: Triggers per page (1-100, default: 20)
format: Response format ('json' or 'markdown')

Returns: Paginated list of triggers.

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    }
  }
}

zendesk_list_active_triggers

List only active triggers.

Args:

format: Response format ('json' or 'markdown')

Returns: List of active triggers.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

zendesk_get_trigger

Get a single trigger by ID.

Args:

triggerId: The trigger ID
format: Response format

Returns: The trigger record with conditions and actions.

{
  "type": "object",
  "required": [
    "triggerId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "triggerId": {
      "type": "integer",
      "description": "Trigger ID"
    }
  }
}

zendesk_search_triggers

Search for triggers by title.

Args:

query: Search query for trigger title
format: Response format

Returns: List of matching triggers.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

zendesk_list_users

List users from Zendesk with pagination.

Args:

page: Page number (default: 1)
perPage: Users per page (1-100, default: 20)
role: Filter by role (end-user, agent, admin)
format: Response format ('json' or 'markdown')

Returns: Paginated list of users with id, name, email, role.

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "role": {
      "enum": [
        "end-user",
        "agent",
        "admin"
      ],
      "type": "string",
      "description": "Filter by role"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    }
  }
}

zendesk_get_user

Get a single user by ID.

Args:

userId: The user ID
format: Response format

Returns: The user record with all available fields.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "userId": {
      "type": "integer",
      "description": "User ID"
    }
  }
}

zendesk_get_current_user

Get the currently authenticated user.

Args:

format: Response format

Returns: The current user record.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

zendesk_get_users_by_ids

Get multiple users by their IDs.

Args:

userIds: Array of user IDs (up to 100)
format: Response format

Returns: Array of user records.

{
  "type": "object",
  "required": [
    "userIds"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "userIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Array of user IDs"
    }
  }
}

zendesk_create_user

Create a new user in Zendesk.

Args:

name: User name (required)
email: Email address
phone: Phone number
role: User role (end-user, agent, admin)
organizationId: Organization ID
externalId: External ID for integrations
tags: Array of tags
verified: Whether the user is verified

Returns: The created user record.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "User name"
    },
    "role": {
      "enum": [
        "end-user",
        "agent",
        "admin"
      ],
      "type": "string",
      "description": "User role"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tags"
    },
    "email": {
      "type": "string",
      "description": "Email address"
    },
    "phone": {
      "type": "string",
      "description": "Phone number"
    },
    "verified": {
      "type": "boolean",
      "description": "Is verified"
    },
    "externalId": {
      "type": "string",
      "description": "External ID"
    },
    "organizationId": {
      "type": "integer",
      "description": "Organization ID"
    }
  }
}

zendesk_update_user

Update an existing user.

Args:

userId: User ID to update
name: New name
email: New email
phone: New phone
role: New role
organizationId: New organization ID
tags: Replace tags
suspended: Suspend or unsuspend user

Returns: The updated user record.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "role": {
      "enum": [
        "end-user",
        "agent",
        "admin"
      ],
      "type": "string"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "email": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "userId": {
      "type": "integer",
      "description": "User ID to update"
    },
    "suspended": {
      "type": "boolean",
      "description": "Suspend or unsuspend"
    },
    "organizationId": {
      "type": "integer"
    }
  }
}

zendesk_delete_user

Delete (soft-delete) a user from Zendesk.

Args:

userId: User ID to delete

Returns: The deleted user record.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "userId": {
      "type": "integer",
      "description": "User ID to delete"
    }
  }
}

zendesk_search_users

Search for users by query.

Args:

query: Search query (searches name, email, phone, external_id)
page: Page number
perPage: Users per page
format: Response format

Returns: Paginated list of matching users.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    }
  }
}

zendesk_list_group_users

List users in a specific group.

Args:

groupId: Group ID
page: Page number
perPage: Users per page
format: Response format

Returns: Paginated list of users in the group.

{
  "type": "object",
  "required": [
    "groupId"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "groupId": {
      "type": "integer",
      "description": "Group ID"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    }
  }
}

zendesk_list_organization_users

List users in a specific organization.

Args:

organizationId: Organization ID
page: Page number
perPage: Users per page
format: Response format

Returns: Paginated list of users in the organization.

{
  "type": "object",
  "required": [
    "organizationId"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "organizationId": {
      "type": "integer",
      "description": "Organization ID"
    }
  }
}

zendesk_suspend_user

Suspend a user account.

Args:

userId: User ID to suspend

Returns: The updated user record.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "userId": {
      "type": "integer",
      "description": "User ID to suspend"
    }
  }
}

zendesk_unsuspend_user

Unsuspend a user account.

Args:

userId: User ID to unsuspend

Returns: The updated user record.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "userId": {
      "type": "integer",
      "description": "User ID to unsuspend"
    }
  }
}

zendesk_list_views

List all views (shared and personal) available to the current user.

Args:

page: Page number (default: 1)
perPage: Views per page (1-100, default: 20)
format: Response format ('json' or 'markdown')

Returns: Paginated list of views.

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    }
  }
}

zendesk_list_active_views

List only active views.

Args:

format: Response format ('json' or 'markdown')

Returns: List of active views.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

zendesk_get_view

Get a single view by ID.

Args:

viewId: The view ID
format: Response format

Returns: The view record with conditions and execution settings.

{
  "type": "object",
  "required": [
    "viewId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "viewId": {
      "type": "integer",
      "description": "View ID"
    }
  }
}

zendesk_execute_view

Execute a view and get the results.

Args:

viewId: The view ID
page: Page number
perPage: Results per page
sortBy: Sort field
sortOrder: Sort direction
format: Response format

Returns: View results with tickets and column data.

{
  "type": "object",
  "required": [
    "viewId"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "sortBy": {
      "type": "string"
    },
    "viewId": {
      "type": "integer",
      "description": "View ID"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "sortOrder": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string"
    }
  }
}

zendesk_get_view_tickets

Get tickets from a view.

Args:

viewId: The view ID
page: Page number
perPage: Tickets per page
format: Response format

Returns: Paginated list of tickets in the view.

{
  "type": "object",
  "required": [
    "viewId"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "viewId": {
      "type": "integer",
      "description": "View ID"
    },
    "perPage": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    }
  }
}

zendesk_get_view_count

Get the ticket count for a view.

Args:

viewId: The view ID

Returns: Ticket count for the view.

{
  "type": "object",
  "required": [
    "viewId"
  ],
  "properties": {
    "viewId": {
      "type": "integer",
      "description": "View ID"
    }
  }
}

zendesk_get_view_counts

Get ticket counts for multiple views.

Args:

viewIds: Array of view IDs

Returns: Array of view counts.

{
  "type": "object",
  "required": [
    "viewIds"
  ],
  "properties": {
    "viewIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "View IDs"
    }
  }
}

zendesk_search_views

Search for views by title.

Args:

query: Search query for view title
format: Response format

Returns: List of matching views.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}