> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# zendesk
> Tickets, users, and organizations
**Server path:** `/zendesk` | **Type:** Application | **PCID required:** Yes
## Tools
| Tool | Description |
| ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`zendesk_list_tickets`](#zendesk_list_tickets) | List Zendesk tickets with optional pagination and sorting. Does NOT support date filtering. For tickets in a time range (e.g., last 7 days, February 2026), use zendesk\_search\_tickets instead with query like "type:ticket created>YYYY-MM-DD". For large date ranges exceeding 1,000 results, use zendesk\_iterate\_tickets\_bulk. |
| [`zendesk_create_ticket`](#zendesk_create_ticket) | Create a new Zendesk ticket. Returns the created ticket object with all fields. |
| [`zendesk_get_ticket`](#zendesk_get_ticket) | Get details of a specific Zendesk ticket. Returns search-style response with results array. |
| [`zendesk_update_ticket`](#zendesk_update_ticket) | Update an existing Zendesk ticket. Returns the updated ticket object. |
| [`zendesk_get_user_info`](#zendesk_get_user_info) | Get information about a Zendesk user |
| [`zendesk_add_ticket_tags`](#zendesk_add_ticket_tags) | Add tags to a Zendesk ticket for organization and filtering |
| [`zendesk_set_ticket_tags`](#zendesk_set_ticket_tags) | Set ticket tags (replaces all existing tags) |
| [`zendesk_remove_ticket_tags`](#zendesk_remove_ticket_tags) | Remove specific tags from a Zendesk ticket |
| [`zendesk_list_ticket_comments`](#zendesk_list_ticket_comments) | List all comments on a Zendesk ticket. Returns array of comment objects. |
| [`zendesk_search_tickets`](#zendesk_search_tickets) | Search Zendesk tickets using query syntax. Use for time-based queries (e.g., type:ticket created>2026-02-01 created\<2026-02-28). Returns total count and pagination info. Use page parameter to fetch subsequent pages when count exceeds 100. Limited to \~1,000 results. For larger result sets, use zendesk\_iterate\_tickets\_bulk instead. |
| [`zendesk_iterate_tickets_bulk`](#zendesk_iterate_tickets_bulk) | Iterate through Zendesk tickets using cursor-based pagination with no result limit. Uses the export search endpoint (search/export.json). Designed for iterating through large or complete result sets. Results are sorted by created\_at only. On the first call (no cursor), returns total count. Pass the returned after\_cursor to fetch subsequent pages. For quick sortable searches under 1,000 results, use zendesk\_search\_tickets instead. |
| [`zendesk_get_ticket_comments_batch`](#zendesk_get_ticket_comments_batch) | Get comments for multiple Zendesk tickets in a single call. Accepts up to 100 ticket IDs per call. Returns up to 100 comments per ticket (first page only). Tickets with more than 100 comments are truncated. Failed tickets are recorded in metadata but do not abort the batch. |
| [`zendesk_delete_ticket`](#zendesk_delete_ticket) | Delete a Zendesk ticket |
| [`zendesk_list_macros`](#zendesk_list_macros) | List all available Zendesk macros for ticket automation |
| [`zendesk_list_trigger_capabilities`](#zendesk_list_trigger_capabilities) | List available trigger types that can be created for Zendesk webhooks |
| [`zendesk_create_trigger`](#zendesk_create_trigger) | Create a Zendesk webhook and trigger with custom conditions |
| [`zendesk_update_trigger`](#zendesk_update_trigger) | Update an existing Zendesk trigger (can update title, category, and conditions) |
| [`zendesk_delete_trigger`](#zendesk_delete_trigger) | Delete a Zendesk webhook and trigger |
***
## zendesk\_list\_tickets
List Zendesk tickets with optional pagination and sorting. Does NOT support date filtering. For tickets in a time range (e.g., last 7 days, February 2026), use zendesk\_search\_tickets instead with query like "type:ticket created>YYYY-MM-DD". For large date ranges exceeding 1,000 results, use zendesk\_iterate\_tickets\_bulk.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | ------ | -------- | ------- | ------------------------------------------------ |
| `page` | number | No | — | Page number for pagination (starts from 1) |
| `per_page` | number | No | — | Number of tickets per page (1-100, default: 100) |
| `sort_by` | string | No | — | Field to sort by |
| `sort_order` | string | No | — | Sort order (ascending or descending) |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"page": {
"type": "number",
"description": "Page number for pagination (starts from 1)"
},
"per_page": {
"type": "number",
"description": "Number of tickets per page (1-100, default: 100)"
},
"sort_by": {
"type": "string",
"enum": [
"created_at",
"updated_at",
"priority",
"status",
"ticket_type"
],
"description": "Field to sort by"
},
"sort_order": {
"type": "string",
"enum": [
"asc",
"desc"
],
"description": "Sort order (ascending or descending)"
}
},
"required": [
"PCID"
]
}
```
***
## zendesk\_create\_ticket
Create a new Zendesk ticket. Returns the created ticket object with all fields.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ---------- | --------- | -------- | ------- | ----------------------------------------- |
| `subject` | string | Yes | — | Subject of the ticket |
| `comment` | string | Yes | — | Initial comment/description of the ticket |
| `priority` | string | No | — | Priority of the ticket |
| `type` | string | No | — | Type of the ticket |
| `tags` | string\[] | No | — | Tags to associate with the ticket |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"subject": {
"type": "string",
"description": "Subject of the ticket"
},
"comment": {
"type": "string",
"description": "Initial comment/description of the ticket"
},
"priority": {
"type": "string",
"enum": [
"urgent",
"high",
"normal",
"low"
],
"description": "Priority of the ticket"
},
"type": {
"type": "string",
"enum": [
"incident",
"problem",
"question",
"task"
],
"description": "Type of the ticket"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags to associate with the ticket"
}
},
"required": [
"PCID",
"subject",
"comment"
]
}
```
***
## zendesk\_get\_ticket
Get details of a specific Zendesk ticket. Returns search-style response with results array.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ---------- | ------ | -------- | ------- | --------------------- |
| `ticketId` | string | Yes | — | Ticket ID to retrieve |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"ticketId": {
"type": "string",
"description": "Ticket ID to retrieve"
}
},
"required": [
"PCID",
"ticketId"
]
}
```
***
## zendesk\_update\_ticket
Update an existing Zendesk ticket. Returns the updated ticket object.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ---------- | --------- | -------- | ------- | ------------------------------------------------------------- |
| `ticketId` | string | Yes | — | Ticket ID to update |
| `status` | string | No | — | New status of the ticket (new, open, pending, solved, closed) |
| `priority` | string | No | — | New priority of the ticket (urgent, high, normal, low) |
| `comment` | string | No | — | New comment to add to the ticket |
| `tags` | string\[] | No | — | New tags to associate with the ticket |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"ticketId": {
"type": "string",
"description": "Ticket ID to update"
},
"status": {
"type": "string",
"enum": [
"new",
"open",
"pending",
"solved",
"closed"
],
"description": "New status of the ticket (new, open, pending, solved, closed)"
},
"priority": {
"type": "string",
"enum": [
"urgent",
"high",
"normal",
"low"
],
"description": "New priority of the ticket (urgent, high, normal, low)"
},
"comment": {
"type": "string",
"description": "New comment to add to the ticket"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "New tags to associate with the ticket"
}
},
"required": [
"PCID",
"ticketId"
]
}
```
***
## zendesk\_get\_user\_info
Get information about a Zendesk user
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------- | ------ | -------- | ------- | ------------------------------------------ |
| `userId` | string | Yes | — | ID of the user to retrieve information for |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"userId": {
"type": "string",
"description": "ID of the user to retrieve information for"
}
},
"required": [
"PCID",
"userId"
]
}
```
***
## zendesk\_add\_ticket\_tags
Add tags to a Zendesk ticket for organization and filtering
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ---------- | --------- | -------- | ------- | ---------------------------------- |
| `ticketId` | string | Yes | — | ID of the ticket to add tags to |
| `tags` | string\[] | Yes | — | Array of tags to add to the ticket |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"ticketId": {
"type": "string",
"description": "ID of the ticket to add tags to"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of tags to add to the ticket"
}
},
"required": [
"PCID",
"ticketId",
"tags"
]
}
```
***
## zendesk\_set\_ticket\_tags
Set ticket tags (replaces all existing tags)
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ---------- | --------- | -------- | ------- | ------------------------------------------------- |
| `ticketId` | string | Yes | — | ID of the ticket to set tags for |
| `tags` | string\[] | Yes | — | Array of tags to set (replaces all existing tags) |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"ticketId": {
"type": "string",
"description": "ID of the ticket to set tags for"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of tags to set (replaces all existing tags)"
}
},
"required": [
"PCID",
"ticketId",
"tags"
]
}
```
***
## zendesk\_remove\_ticket\_tags
Remove specific tags from a Zendesk ticket
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ---------- | --------- | -------- | ------- | --------------------------------------- |
| `ticketId` | string | Yes | — | ID of the ticket to remove tags from |
| `tags` | string\[] | Yes | — | Array of tags to remove from the ticket |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"ticketId": {
"type": "string",
"description": "ID of the ticket to remove tags from"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of tags to remove from the ticket"
}
},
"required": [
"PCID",
"ticketId",
"tags"
]
}
```
***
## zendesk\_list\_ticket\_comments
List all comments on a Zendesk ticket. Returns array of comment objects.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ---------- | ------ | -------- | ------- | ------------------------------------- |
| `ticketId` | string | Yes | — | ID of the ticket to list comments for |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"ticketId": {
"type": "string",
"description": "ID of the ticket to list comments for"
}
},
"required": [
"PCID",
"ticketId"
]
}
```
***
## zendesk\_search\_tickets
Search Zendesk tickets using query syntax. Use for time-based queries (e.g., type:ticket created>2026-02-01 created\<2026-02-28). Returns total count and pagination info. Use page parameter to fetch subsequent pages when count exceeds 100. Limited to \~1,000 results. For larger result sets, use zendesk\_iterate\_tickets\_bulk instead.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------- | ------ | -------- | ------- | -------------------------------------------------------------------------------------------------- |
| `query` | string | Yes | — | Search query (e.g., "type:ticket status:open" or "type:ticket created>2026-02-01" for time ranges) |
| `sortBy` | string | No | — | Field to sort by (created\_at, updated\_at, priority, etc.) |
| `sortOrder` | string | No | — | Sort order |
| `page` | number | No | — | Page number for pagination (1-based). Use to fetch pages 2, 3, etc. when next\_page is returned. |
| `per_page` | number | No | — | Results per page (1-100, default 100) |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"query": {
"type": "string",
"description": "Search query (e.g., \"type:ticket status:open\" or \"type:ticket created>2026-02-01\" for time ranges)"
},
"sortBy": {
"type": "string",
"description": "Field to sort by (created_at, updated_at, priority, etc.)"
},
"sortOrder": {
"type": "string",
"enum": [
"asc",
"desc"
],
"description": "Sort order"
},
"page": {
"type": "number",
"description": "Page number for pagination (1-based). Use to fetch pages 2, 3, etc. when next_page is returned."
},
"per_page": {
"type": "number",
"description": "Results per page (1-100, default 100)"
}
},
"required": [
"PCID",
"query"
]
}
```
***
## zendesk\_iterate\_tickets\_bulk
Iterate through Zendesk tickets using cursor-based pagination with no result limit. Uses the export search endpoint (search/export.json). Designed for iterating through large or complete result sets. Results are sorted by created\_at only. On the first call (no cursor), returns total count. Pass the returned after\_cursor to fetch subsequent pages. For quick sortable searches under 1,000 results, use zendesk\_search\_tickets instead.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ---------- | ------ | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Yes | — | Search query using Zendesk search syntax (e.g., "status:open created>2025-01-01"). type:ticket is handled automatically — do not include it. |
| `cursor` | string | No | — | Opaque cursor from a previous response's after\_cursor field. Omit on the first call. |
| `pageSize` | number | No | — | Results per page (1-100, default 100) |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"query": {
"type": "string",
"description": "Search query using Zendesk search syntax (e.g., \"status:open created>2025-01-01\"). type:ticket is handled automatically — do not include it."
},
"cursor": {
"type": "string",
"description": "Opaque cursor from a previous response's after_cursor field. Omit on the first call."
},
"pageSize": {
"type": "number",
"description": "Results per page (1-100, default 100)"
}
},
"required": [
"PCID",
"query"
]
}
```
***
## zendesk\_get\_ticket\_comments\_batch
Get comments for multiple Zendesk tickets in a single call. Accepts up to 100 ticket IDs per call. Returns up to 100 comments per ticket (first page only). Tickets with more than 100 comments are truncated. Failed tickets are recorded in metadata but do not abort the batch.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------- | --------- | -------- | ------- | --------------------------------------------------- |
| `ticketIds` | string\[] | Yes | — | Array of ticket IDs to fetch comments for (max 100) |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"ticketIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of ticket IDs to fetch comments for (max 100)"
}
},
"required": [
"PCID",
"ticketIds"
]
}
```
***
## zendesk\_delete\_ticket
Delete a Zendesk ticket
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ---------- | ------ | -------- | ------- | -------------------------- |
| `ticketId` | string | Yes | — | ID of the ticket to delete |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"ticketId": {
"type": "string",
"description": "ID of the ticket to delete"
}
},
"required": [
"PCID",
"ticketId"
]
}
```
***
## zendesk\_list\_macros
List all available Zendesk macros for ticket automation
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
}
},
"required": [
"PCID"
]
}
```
***
## zendesk\_list\_trigger\_capabilities
List available trigger types that can be created for Zendesk webhooks
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID (optional for this operation)"
}
}
}
```
***
## zendesk\_create\_trigger
Create a Zendesk webhook and trigger with custom conditions
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `triggerType` | string | Yes | — | Type of trigger to create |
| `webhookUrl` | string | Yes | — | The webhook URL where Zendesk should send events |
| `title` | string | Yes | — | Name for the trigger |
| `categoryId` | string | No | — | Optional category ID |
| `conditions` | string | No | — | Trigger conditions (optional - defaults to all ticket updates when empty or not provided). Format: \{"all": \[\{"field": "status", "value": "new"}]} |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"triggerType": {
"type": "string",
"enum": [
"zendesk_ticket_events"
],
"description": "Type of trigger to create"
},
"webhookUrl": {
"type": "string",
"description": "The webhook URL where Zendesk should send events"
},
"title": {
"type": "string",
"description": "Name for the trigger"
},
"categoryId": {
"type": "string",
"description": "Optional category ID"
},
"conditions": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"all": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"operator": {
"type": "string"
},
"value": {
"oneOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"description": "All conditions must match (AND logic)"
},
"any": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"operator": {
"type": "string"
},
"value": {
"oneOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"description": "Any condition must match (OR logic)"
}
}
}
],
"description": "Trigger conditions (optional - defaults to all ticket updates when empty or not provided). Format: {\"all\": [{\"field\": \"status\", \"value\": \"new\"}]}"
}
},
"required": [
"PCID",
"triggerType",
"webhookUrl",
"title"
]
}
```
***
## zendesk\_update\_trigger
Update an existing Zendesk trigger (can update title, category, and conditions)
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | ------ | -------- | ------- | -------------------------------------------------------------------------------------------- |
| `triggerId` | string | Yes | — | The ID of the trigger to update |
| `webhookId` | string | Yes | — | The webhook ID associated with this trigger |
| `title` | string | No | — | New title for the trigger |
| `categoryId` | string | No | — | New category ID |
| `conditions` | string | No | — | New trigger conditions (optional). Format: \{"all": \[\{"field": "status", "value": "new"}]} |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"triggerId": {
"type": "string",
"description": "The ID of the trigger to update"
},
"webhookId": {
"type": "string",
"description": "The webhook ID associated with this trigger"
},
"title": {
"type": "string",
"description": "New title for the trigger"
},
"categoryId": {
"type": "string",
"description": "New category ID"
},
"conditions": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"all": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"operator": {
"type": "string"
},
"value": {
"oneOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"description": "All conditions must match (AND logic)"
},
"any": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"operator": {
"type": "string"
},
"value": {
"oneOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"description": "Any condition must match (OR logic)"
}
}
}
],
"description": "New trigger conditions (optional). Format: {\"all\": [{\"field\": \"status\", \"value\": \"new\"}]}"
}
},
"required": [
"PCID",
"triggerId",
"webhookId"
]
}
```
***
## zendesk\_delete\_trigger
Delete a Zendesk webhook and trigger
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------- | ------ | -------- | ------- | ---------------------------------------------------------------------- |
| `triggerId` | string | Yes | — | The ID of the trigger to delete |
| `webhookId` | string | No | — | Optional webhook ID (if not provided, will be retrieved from metadata) |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"triggerId": {
"type": "string",
"description": "The ID of the trigger to delete"
},
"webhookId": {
"type": "string",
"description": "Optional webhook ID (if not provided, will be retrieved from metadata)"
}
},
"required": [
"PCID",
"triggerId"
]
}
```