> ## 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.
# freshservice-tickets
> Freshservice Tickets — create, update, filter, and manage IT support tickets, conversations, tasks, time entries, and approvals
**Server path:** `/freshservice-tickets` | **Type:** Application | **PCID required:** Yes
## Tools
| Tool | Description |
| --------------------------------------------------------------------------------------------------- | ---------------------------------- |
| [`freshservice_tickets_add_ticket_note`](#freshservice_tickets_add_ticket_note) | Create a Note on a Ticket |
| [`freshservice_tickets_cancel_ticket_approval`](#freshservice_tickets_cancel_ticket_approval) | Cancel a Ticket Approval |
| [`freshservice_tickets_create_child_ticket`](#freshservice_tickets_create_child_ticket) | Create Child Ticket |
| [`freshservice_tickets_create_ticket`](#freshservice_tickets_create_ticket) | Create a Ticket |
| [`freshservice_tickets_create_ticket_task`](#freshservice_tickets_create_ticket_task) | Create a Ticket Task |
| [`freshservice_tickets_create_ticket_time_entry`](#freshservice_tickets_create_ticket_time_entry) | Create a Ticket Time Entry |
| [`freshservice_tickets_delete_conversation`](#freshservice_tickets_delete_conversation) | Delete a Conversation |
| [`freshservice_tickets_delete_ticket`](#freshservice_tickets_delete_ticket) | Delete a Ticket (trash) |
| [`freshservice_tickets_delete_ticket_attachment`](#freshservice_tickets_delete_ticket_attachment) | Delete Ticket Attachment |
| [`freshservice_tickets_delete_ticket_task`](#freshservice_tickets_delete_ticket_task) | Delete a Ticket Task |
| [`freshservice_tickets_delete_ticket_time_entry`](#freshservice_tickets_delete_ticket_time_entry) | Delete a Ticket Time Entry |
| [`freshservice_tickets_filter_tickets`](#freshservice_tickets_filter_tickets) | Filter Tickets |
| [`freshservice_tickets_get_ticket`](#freshservice_tickets_get_ticket) | View a Ticket |
| [`freshservice_tickets_get_ticket_activities`](#freshservice_tickets_get_ticket_activities) | Get Ticket Activity |
| [`freshservice_tickets_get_ticket_approval`](#freshservice_tickets_get_ticket_approval) | View a Ticket Approval |
| [`freshservice_tickets_get_ticket_csat_response`](#freshservice_tickets_get_ticket_csat_response) | View CSAT Response |
| [`freshservice_tickets_get_ticket_task`](#freshservice_tickets_get_ticket_task) | View a Ticket Task |
| [`freshservice_tickets_get_ticket_time_entry`](#freshservice_tickets_get_ticket_time_entry) | View a Ticket Time Entry |
| [`freshservice_tickets_list_ticket_approvals`](#freshservice_tickets_list_ticket_approvals) | List Ticket Approvals |
| [`freshservice_tickets_list_ticket_conversations`](#freshservice_tickets_list_ticket_conversations) | List All Conversations of a Ticket |
| [`freshservice_tickets_list_ticket_fields`](#freshservice_tickets_list_ticket_fields) | List All Ticket Fields |
| [`freshservice_tickets_list_ticket_tasks`](#freshservice_tickets_list_ticket_tasks) | List All Ticket Tasks |
| [`freshservice_tickets_list_ticket_time_entries`](#freshservice_tickets_list_ticket_time_entries) | List All Ticket Time Entries |
| [`freshservice_tickets_list_tickets`](#freshservice_tickets_list_tickets) | List All Tickets |
| [`freshservice_tickets_reply_to_ticket`](#freshservice_tickets_reply_to_ticket) | Reply to a Ticket |
| [`freshservice_tickets_request_ticket_approval`](#freshservice_tickets_request_ticket_approval) | Request Approval on a Ticket |
| [`freshservice_tickets_restore_ticket`](#freshservice_tickets_restore_ticket) | Restore a Trashed Ticket |
| [`freshservice_tickets_update_conversation`](#freshservice_tickets_update_conversation) | Update a Conversation |
| [`freshservice_tickets_update_ticket`](#freshservice_tickets_update_ticket) | Update a Ticket |
| [`freshservice_tickets_update_ticket_task`](#freshservice_tickets_update_ticket_task) | Update a Ticket Task |
| [`freshservice_tickets_update_ticket_time_entry`](#freshservice_tickets_update_ticket_time_entry) | Update a Ticket Time Entry |
***
## freshservice\_tickets\_add\_ticket\_note
Create a Note on a Ticket
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------------- | --------- | -------- | ------- | --------------------------- |
| `ticket_id` | integer | Yes | — | Ticket ID |
| `body` | string | Yes | — | Note HTML body |
| `notify_emails` | string\[] | No | — | Emails to notify |
| `private` | boolean | No | — | Private note (default true) |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
},
"body": {
"type": "string",
"description": "Note HTML body"
},
"notify_emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Emails to notify"
},
"private": {
"type": "boolean",
"description": "Private note (default true)"
}
},
"required": [
"PCID",
"ticket_id",
"body"
]
}
```
***
## freshservice\_tickets\_cancel\_ticket\_approval
Cancel a Ticket Approval
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------- | ------- | -------- | ------- | ----------- |
| `ticket_id` | integer | Yes | — | Ticket ID |
| `approval_id` | integer | Yes | — | Approval ID |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
},
"approval_id": {
"type": "integer",
"description": "Approval ID"
}
},
"required": [
"PCID",
"ticket_id",
"approval_id"
]
}
```
***
## freshservice\_tickets\_create\_child\_ticket
Create Child Ticket
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------- | ------- | -------- | ------- | --------------------- |
| `parent_id` | integer | Yes | — | Parent ticket ID |
| `description` | string | No | — | The description value |
| `email` | string | No | — | Requester email |
| `priority` | integer | No | — | The priority value |
| `status` | integer | No | — | The status value |
| `subject` | string | Yes | — | The subject value |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"parent_id": {
"type": "integer",
"description": "Parent ticket ID"
},
"description": {
"type": "string",
"description": "The description value"
},
"email": {
"type": "string",
"description": "Requester email"
},
"priority": {
"type": "integer",
"description": "The priority value"
},
"status": {
"type": "integer",
"description": "The status value"
},
"subject": {
"type": "string",
"description": "The subject value"
}
},
"required": [
"PCID",
"parent_id",
"subject"
]
}
```
***
## freshservice\_tickets\_create\_ticket
Create a Ticket
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------------- | --------- | -------- | ------- | ----------------------------------------------------- |
| `assets` | object\[] | No | — | Associated assets |
| `category` | string | No | — | The category value |
| `cc_emails` | string\[] | No | — | CC email addresses |
| `custom_fields` | object | No | — | Custom field key-value pairs |
| `department_id` | integer | No | — | Department ID |
| `description` | string | No | — | HTML description |
| `due_by` | string | No | — | Resolution due (ISO 8601) |
| `email` | string | No | — | Requester email |
| `fr_due_by` | string | No | — | First response due (ISO 8601) |
| `group_id` | integer | No | — | Assigned group ID |
| `impact` | integer | No | — | Impact level |
| `item_category` | string | No | — | Item category |
| `name` | string | No | — | Requester name |
| `phone` | string | No | — | Requester phone |
| `priority` | integer | No | — | 1=Low, 2=Medium, 3=High, 4=Urgent |
| `requester_id` | integer | No | — | Requester user ID |
| `responder_id` | integer | No | — | Assigned agent ID |
| `source` | integer | No | — | 1=Email, 2=Portal, 3=Phone, 4=Chat, 7=Feedback Widget |
| `status` | integer | No | — | 2=Open, 3=Pending, 4=Resolved, 5=Closed |
| `sub_category` | string | No | — | Sub-category |
| `subject` | string | Yes | — | Ticket subject |
| `tags` | string\[] | No | — | The tags value |
| `type` | string | No | — | Incident, Service Request, etc. |
| `urgency` | integer | No | — | Urgency level |
| `workspace_id` | integer | No | — | Workspace ID |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"assets": {
"type": "array",
"items": {
"type": "object"
},
"description": "Associated assets"
},
"category": {
"type": "string",
"description": "The category value"
},
"cc_emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "CC email addresses"
},
"custom_fields": {
"type": "object",
"description": "Custom field key-value pairs"
},
"department_id": {
"type": "integer",
"description": "Department ID"
},
"description": {
"type": "string",
"description": "HTML description"
},
"due_by": {
"type": "string",
"description": "Resolution due (ISO 8601)"
},
"email": {
"type": "string",
"description": "Requester email"
},
"fr_due_by": {
"type": "string",
"description": "First response due (ISO 8601)"
},
"group_id": {
"type": "integer",
"description": "Assigned group ID"
},
"impact": {
"type": "integer",
"description": "Impact level"
},
"item_category": {
"type": "string",
"description": "Item category"
},
"name": {
"type": "string",
"description": "Requester name"
},
"phone": {
"type": "string",
"description": "Requester phone"
},
"priority": {
"type": "integer",
"description": "1=Low, 2=Medium, 3=High, 4=Urgent"
},
"requester_id": {
"type": "integer",
"description": "Requester user ID"
},
"responder_id": {
"type": "integer",
"description": "Assigned agent ID"
},
"source": {
"type": "integer",
"description": "1=Email, 2=Portal, 3=Phone, 4=Chat, 7=Feedback Widget"
},
"status": {
"type": "integer",
"description": "2=Open, 3=Pending, 4=Resolved, 5=Closed"
},
"sub_category": {
"type": "string",
"description": "Sub-category"
},
"subject": {
"type": "string",
"description": "Ticket subject"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "The tags value"
},
"type": {
"type": "string",
"description": "Incident, Service Request, etc."
},
"urgency": {
"type": "integer",
"description": "Urgency level"
},
"workspace_id": {
"type": "integer",
"description": "Workspace ID"
}
},
"required": [
"PCID",
"subject"
]
}
```
***
## freshservice\_tickets\_create\_ticket\_task
Create a Ticket Task
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------------- | ------- | -------- | ------- | ---------------------------------- |
| `ticket_id` | integer | Yes | — | Ticket ID |
| `agent_id` | integer | No | — | Assigned agent ID |
| `description` | string | No | — | Task description |
| `due_date` | string | No | — | Due date (ISO 8601) |
| `group_id` | integer | No | — | Assigned group ID |
| `notify_before` | integer | No | — | Seconds before due date to notify |
| `status` | integer | No | — | 1=Open, 2=In Progress, 3=Completed |
| `title` | string | Yes | — | Task title |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
},
"agent_id": {
"type": "integer",
"description": "Assigned agent ID"
},
"description": {
"type": "string",
"description": "Task description"
},
"due_date": {
"type": "string",
"description": "Due date (ISO 8601)"
},
"group_id": {
"type": "integer",
"description": "Assigned group ID"
},
"notify_before": {
"type": "integer",
"description": "Seconds before due date to notify"
},
"status": {
"type": "integer",
"description": "1=Open, 2=In Progress, 3=Completed"
},
"title": {
"type": "string",
"description": "Task title"
}
},
"required": [
"PCID",
"ticket_id",
"title"
]
}
```
***
## freshservice\_tickets\_create\_ticket\_time\_entry
Create a Ticket Time Entry
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------- | ------- | -------- | ------- | ----------------------------- |
| `ticket_id` | integer | Yes | — | Ticket ID |
| `agent_id` | integer | Yes | — | Agent ID (mandatory) |
| `billable` | boolean | No | — | Billable entry (default true) |
| `executed_at` | string | No | — | When work was done (ISO 8601) |
| `note` | string | No | — | Description of work |
| `start_time` | string | No | — | Start time (ISO 8601) |
| `task_id` | integer | No | — | Associated task ID |
| `time_spent` | string | No | — | Time spent in hh:mm format |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
},
"agent_id": {
"type": "integer",
"description": "Agent ID (mandatory)"
},
"billable": {
"type": "boolean",
"description": "Billable entry (default true)"
},
"executed_at": {
"type": "string",
"description": "When work was done (ISO 8601)"
},
"note": {
"type": "string",
"description": "Description of work"
},
"start_time": {
"type": "string",
"description": "Start time (ISO 8601)"
},
"task_id": {
"type": "integer",
"description": "Associated task ID"
},
"time_spent": {
"type": "string",
"description": "Time spent in hh:mm format"
}
},
"required": [
"PCID",
"ticket_id",
"agent_id"
]
}
```
***
## freshservice\_tickets\_delete\_conversation
Delete a Conversation
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------------- | ------- | -------- | ------- | --------------- |
| `conversation_id` | integer | Yes | — | Conversation ID |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"conversation_id": {
"type": "integer",
"description": "Conversation ID"
}
},
"required": [
"PCID",
"conversation_id"
]
}
```
***
## freshservice\_tickets\_delete\_ticket
Delete a Ticket (trash)
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------- | ------- | -------- | ------- | ----------- |
| `ticket_id` | integer | Yes | — | Ticket ID |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
}
},
"required": [
"PCID",
"ticket_id"
]
}
```
***
## freshservice\_tickets\_delete\_ticket\_attachment
Delete Ticket Attachment
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------------- | ------- | -------- | ------- | ------------- |
| `ticket_id` | integer | Yes | — | Ticket ID |
| `attachment_id` | integer | Yes | — | Attachment ID |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
},
"attachment_id": {
"type": "integer",
"description": "Attachment ID"
}
},
"required": [
"PCID",
"ticket_id",
"attachment_id"
]
}
```
***
## freshservice\_tickets\_delete\_ticket\_task
Delete a Ticket Task
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------- | ------- | -------- | ------- | ----------- |
| `ticket_id` | integer | Yes | — | Ticket ID |
| `task_id` | integer | Yes | — | Task ID |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
},
"task_id": {
"type": "integer",
"description": "Task ID"
}
},
"required": [
"PCID",
"ticket_id",
"task_id"
]
}
```
***
## freshservice\_tickets\_delete\_ticket\_time\_entry
Delete a Ticket Time Entry
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------------- | ------- | -------- | ------- | ------------- |
| `ticket_id` | integer | Yes | — | Ticket ID |
| `time_entry_id` | integer | Yes | — | Time Entry ID |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
},
"time_entry_id": {
"type": "integer",
"description": "Time Entry ID"
}
},
"required": [
"PCID",
"ticket_id",
"time_entry_id"
]
}
```
***
## freshservice\_tickets\_filter\_tickets
Filter Tickets
**Parameters:**
| Parameter | Type | Required | Default | Description |
| -------------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------ |
| `query` | string | Yes | — | Filter query, e.g. asset\_type\_id:1 — do NOT include surrounding quotes, they are added automatically |
| `workspace_id` | integer | No | — | Workspace ID |
| `page` | integer | No | — | Page number |
| `per_page` | integer | No | — | Items per page (max 100) |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"query": {
"type": "string",
"description": "Filter query, e.g. asset_type_id:1 — do NOT include surrounding quotes, they are added automatically"
},
"workspace_id": {
"type": "integer",
"description": "Workspace ID"
},
"page": {
"type": "integer",
"description": "Page number"
},
"per_page": {
"type": "integer",
"description": "Items per page (max 100)"
}
},
"required": [
"PCID",
"query"
]
}
```
***
## freshservice\_tickets\_get\_ticket
View a Ticket
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------- |
| `ticket_id` | integer | Yes | — | Ticket ID |
| `include` | string | No | — | Include: conversations, requester, requested\_for, stats, problem, assets, changes, related\_tickets, tags |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
},
"include": {
"type": "string",
"description": "Include: conversations, requester, requested_for, stats, problem, assets, changes, related_tickets, tags"
}
},
"required": [
"PCID",
"ticket_id"
]
}
```
***
## freshservice\_tickets\_get\_ticket\_activities
Get Ticket Activity
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------- | ------- | -------- | ------- | ----------- |
| `ticket_id` | integer | Yes | — | Ticket ID |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
}
},
"required": [
"PCID",
"ticket_id"
]
}
```
***
## freshservice\_tickets\_get\_ticket\_approval
View a Ticket Approval
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------- | ------- | -------- | ------- | ----------- |
| `ticket_id` | integer | Yes | — | Ticket ID |
| `approval_id` | integer | Yes | — | Approval ID |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
},
"approval_id": {
"type": "integer",
"description": "Approval ID"
}
},
"required": [
"PCID",
"ticket_id",
"approval_id"
]
}
```
***
## freshservice\_tickets\_get\_ticket\_csat\_response
View CSAT Response
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------- | ------- | -------- | ------- | ----------- |
| `ticket_id` | integer | Yes | — | Ticket ID |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
}
},
"required": [
"PCID",
"ticket_id"
]
}
```
***
## freshservice\_tickets\_get\_ticket\_task
View a Ticket Task
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------- | ------- | -------- | ------- | ----------- |
| `ticket_id` | integer | Yes | — | Ticket ID |
| `task_id` | integer | Yes | — | Task ID |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
},
"task_id": {
"type": "integer",
"description": "Task ID"
}
},
"required": [
"PCID",
"ticket_id",
"task_id"
]
}
```
***
## freshservice\_tickets\_get\_ticket\_time\_entry
View a Ticket Time Entry
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------------- | ------- | -------- | ------- | ------------- |
| `ticket_id` | integer | Yes | — | Ticket ID |
| `time_entry_id` | integer | Yes | — | Time Entry ID |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
},
"time_entry_id": {
"type": "integer",
"description": "Time Entry ID"
}
},
"required": [
"PCID",
"ticket_id",
"time_entry_id"
]
}
```
***
## freshservice\_tickets\_list\_ticket\_approvals
List Ticket Approvals
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------- | ------- | -------- | ------- | ----------- |
| `ticket_id` | integer | Yes | — | Ticket ID |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
}
},
"required": [
"PCID",
"ticket_id"
]
}
```
***
## freshservice\_tickets\_list\_ticket\_conversations
List All Conversations of a Ticket
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------- | ------- | -------- | ------- | ------------------------ |
| `ticket_id` | integer | Yes | — | Ticket ID |
| `page` | integer | No | — | Page number |
| `per_page` | integer | No | — | Items per page (max 100) |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
},
"page": {
"type": "integer",
"description": "Page number"
},
"per_page": {
"type": "integer",
"description": "Items per page (max 100)"
}
},
"required": [
"PCID",
"ticket_id"
]
}
```
***
## freshservice\_tickets\_list\_ticket\_fields
List All Ticket Fields
**Parameters:**
| Parameter | Type | Required | Default | Description |
| -------------- | ------- | -------- | ------- | ------------ |
| `workspace_id` | integer | No | — | Workspace ID |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"workspace_id": {
"type": "integer",
"description": "Workspace ID"
}
},
"required": [
"PCID"
]
}
```
***
## freshservice\_tickets\_list\_ticket\_tasks
List All Ticket Tasks
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------- | ------- | -------- | ------- | ------------------------ |
| `ticket_id` | integer | Yes | — | Ticket ID |
| `page` | integer | No | — | Page number |
| `per_page` | integer | No | — | Items per page (max 100) |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
},
"page": {
"type": "integer",
"description": "Page number"
},
"per_page": {
"type": "integer",
"description": "Items per page (max 100)"
}
},
"required": [
"PCID",
"ticket_id"
]
}
```
***
## freshservice\_tickets\_list\_ticket\_time\_entries
List All Ticket Time Entries
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------- | ------- | -------- | ------- | ------------------------ |
| `ticket_id` | integer | Yes | — | Ticket ID |
| `page` | integer | No | — | Page number |
| `per_page` | integer | No | — | Items per page (max 100) |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
},
"page": {
"type": "integer",
"description": "Page number"
},
"per_page": {
"type": "integer",
"description": "Items per page (max 100)"
}
},
"required": [
"PCID",
"ticket_id"
]
}
```
***
## freshservice\_tickets\_list\_tickets
List All Tickets
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------------- | ------- | -------- | ------- | -------------------------------------------------------------- |
| `page` | integer | No | — | Page number |
| `per_page` | integer | No | — | Items per page (max 100) |
| `filter` | string | No | — | Predefined filter: new\_and\_my\_open, watching, spam, deleted |
| `requester_id` | integer | No | — | Filter by requester ID |
| `email` | string | No | — | Filter by requester email |
| `updated_since` | string | No | — | Filter by last update (ISO 8601) |
| `type` | string | No | — | Filter by ticket type |
| `workspace_id` | integer | No | — | Filter by workspace |
| `order_type` | string | No | — | asc or desc |
| `include` | string | No | — | Include: stats, requester, requested\_for |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"page": {
"type": "integer",
"description": "Page number"
},
"per_page": {
"type": "integer",
"description": "Items per page (max 100)"
},
"filter": {
"type": "string",
"description": "Predefined filter: new_and_my_open, watching, spam, deleted"
},
"requester_id": {
"type": "integer",
"description": "Filter by requester ID"
},
"email": {
"type": "string",
"description": "Filter by requester email"
},
"updated_since": {
"type": "string",
"description": "Filter by last update (ISO 8601)"
},
"type": {
"type": "string",
"description": "Filter by ticket type"
},
"workspace_id": {
"type": "integer",
"description": "Filter by workspace"
},
"order_type": {
"type": "string",
"description": "asc or desc"
},
"include": {
"type": "string",
"description": "Include: stats, requester, requested_for"
}
},
"required": [
"PCID"
]
}
```
***
## freshservice\_tickets\_reply\_to\_ticket
Reply to a Ticket
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | --------- | -------- | ------- | --------------- |
| `ticket_id` | integer | Yes | — | Ticket ID |
| `bcc_emails` | string\[] | No | — | BCC emails |
| `body` | string | Yes | — | Reply HTML body |
| `cc_emails` | string\[] | No | — | CC emails |
| `from_email` | string | No | — | Sender email |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
},
"bcc_emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "BCC emails"
},
"body": {
"type": "string",
"description": "Reply HTML body"
},
"cc_emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "CC emails"
},
"from_email": {
"type": "string",
"description": "Sender email"
}
},
"required": [
"PCID",
"ticket_id",
"body"
]
}
```
***
## freshservice\_tickets\_request\_ticket\_approval
Request Approval on a Ticket
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------------- | ------- | -------- | ------- | --------------------------------------------- |
| `ticket_id` | integer | Yes | — | Ticket ID |
| `approval_type` | integer | No | — | 1=Everyone must approve, 2=Anyone can approve |
| `approver_id` | integer | No | — | Approver agent ID |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
},
"approval_type": {
"type": "integer",
"description": "1=Everyone must approve, 2=Anyone can approve"
},
"approver_id": {
"type": "integer",
"description": "Approver agent ID"
}
},
"required": [
"PCID",
"ticket_id"
]
}
```
***
## freshservice\_tickets\_restore\_ticket
Restore a Trashed Ticket
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------- | ------- | -------- | ------- | ----------- |
| `ticket_id` | integer | Yes | — | Ticket ID |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
}
},
"required": [
"PCID",
"ticket_id"
]
}
```
***
## freshservice\_tickets\_update\_conversation
Update a Conversation
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------------- | ------- | -------- | ------- | ----------------- |
| `conversation_id` | integer | Yes | — | Conversation ID |
| `body` | string | No | — | Updated HTML body |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"conversation_id": {
"type": "integer",
"description": "Conversation ID"
},
"body": {
"type": "string",
"description": "Updated HTML body"
}
},
"required": [
"PCID",
"conversation_id"
]
}
```
***
## freshservice\_tickets\_update\_ticket
Update a Ticket
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------------- | --------- | -------- | ------- | --------------------------------------- |
| `ticket_id` | integer | Yes | — | Ticket ID |
| `category` | string | No | — | The category value |
| `custom_fields` | object | No | — | Custom fields |
| `department_id` | integer | No | — | Department ID |
| `description` | string | No | — | HTML description |
| `due_by` | string | No | — | Resolution due |
| `fr_due_by` | string | No | — | First response due |
| `group_id` | integer | No | — | Assigned group ID |
| `impact` | integer | No | — | The impact value |
| `item_category` | string | No | — | Item category |
| `priority` | integer | No | — | 1=Low, 2=Medium, 3=High, 4=Urgent |
| `responder_id` | integer | No | — | Assigned agent ID |
| `source` | integer | No | — | The source value |
| `status` | integer | No | — | 2=Open, 3=Pending, 4=Resolved, 5=Closed |
| `sub_category` | string | No | — | Sub-category |
| `subject` | string | No | — | The subject value |
| `tags` | string\[] | No | — | The tags value |
| `type` | string | No | — | Ticket type |
| `urgency` | integer | No | — | The urgency value |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
},
"category": {
"type": "string",
"description": "The category value"
},
"custom_fields": {
"type": "object",
"description": "Custom fields"
},
"department_id": {
"type": "integer",
"description": "Department ID"
},
"description": {
"type": "string",
"description": "HTML description"
},
"due_by": {
"type": "string",
"description": "Resolution due"
},
"fr_due_by": {
"type": "string",
"description": "First response due"
},
"group_id": {
"type": "integer",
"description": "Assigned group ID"
},
"impact": {
"type": "integer",
"description": "The impact value"
},
"item_category": {
"type": "string",
"description": "Item category"
},
"priority": {
"type": "integer",
"description": "1=Low, 2=Medium, 3=High, 4=Urgent"
},
"responder_id": {
"type": "integer",
"description": "Assigned agent ID"
},
"source": {
"type": "integer",
"description": "The source value"
},
"status": {
"type": "integer",
"description": "2=Open, 3=Pending, 4=Resolved, 5=Closed"
},
"sub_category": {
"type": "string",
"description": "Sub-category"
},
"subject": {
"type": "string",
"description": "The subject value"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "The tags value"
},
"type": {
"type": "string",
"description": "Ticket type"
},
"urgency": {
"type": "integer",
"description": "The urgency value"
}
},
"required": [
"PCID",
"ticket_id"
]
}
```
***
## freshservice\_tickets\_update\_ticket\_task
Update a Ticket Task
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------- | ------- | -------- | ------- | --------------------- |
| `ticket_id` | integer | Yes | — | Ticket ID |
| `task_id` | integer | Yes | — | Task ID |
| `agent_id` | integer | No | — | Assigned agent |
| `description` | string | No | — | The description value |
| `due_date` | string | No | — | Due date |
| `group_id` | integer | No | — | Assigned group |
| `status` | integer | No | — | The status value |
| `title` | string | No | — | The title value |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
},
"task_id": {
"type": "integer",
"description": "Task ID"
},
"agent_id": {
"type": "integer",
"description": "Assigned agent"
},
"description": {
"type": "string",
"description": "The description value"
},
"due_date": {
"type": "string",
"description": "Due date"
},
"group_id": {
"type": "integer",
"description": "Assigned group"
},
"status": {
"type": "integer",
"description": "The status value"
},
"title": {
"type": "string",
"description": "The title value"
}
},
"required": [
"PCID",
"ticket_id",
"task_id"
]
}
```
***
## freshservice\_tickets\_update\_ticket\_time\_entry
Update a Ticket Time Entry
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------------- | ------- | -------- | ------- | ------------------ |
| `ticket_id` | integer | Yes | — | Ticket ID |
| `time_entry_id` | integer | Yes | — | Time Entry ID |
| `agent_id` | integer | No | — | Agent ID |
| `billable` | boolean | No | — | The billable value |
| `executed_at` | string | No | — | Execution time |
| `note` | string | No | — | Description |
| `time_spent` | string | No | — | Time in hh:mm |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"ticket_id": {
"type": "integer",
"description": "Ticket ID"
},
"time_entry_id": {
"type": "integer",
"description": "Time Entry ID"
},
"agent_id": {
"type": "integer",
"description": "Agent ID"
},
"billable": {
"type": "boolean",
"description": "The billable value"
},
"executed_at": {
"type": "string",
"description": "Execution time"
},
"note": {
"type": "string",
"description": "Description"
},
"time_spent": {
"type": "string",
"description": "Time in hh:mm"
}
},
"required": [
"PCID",
"ticket_id",
"time_entry_id"
]
}
```