> ## 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.

# freshdesk-tickets

> Freshdesk Tickets - Create, update, search, forward, merge tickets, manage conversations and forms

**Server path:** `/freshdesk-tickets` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                          | Description                     |
| --------------------------------------------------------------------------------------------- | ------------------------------- |
| [`freshdesk_tickets_add_note_to_ticket`](#freshdesk_tickets_add_note_to_ticket)               | Add a note to a ticket          |
| [`freshdesk_tickets_create_ticket`](#freshdesk_tickets_create_ticket)                         | Create a ticket                 |
| [`freshdesk_tickets_create_ticket_form`](#freshdesk_tickets_create_ticket_form)               | Create a ticket form            |
| [`freshdesk_tickets_delete_conversation`](#freshdesk_tickets_delete_conversation)             | Delete a conversation           |
| [`freshdesk_tickets_delete_ticket`](#freshdesk_tickets_delete_ticket)                         | Delete a ticket                 |
| [`freshdesk_tickets_delete_ticket_form`](#freshdesk_tickets_delete_ticket_form)               | Delete a ticket form            |
| [`freshdesk_tickets_forward_ticket`](#freshdesk_tickets_forward_ticket)                       | Forward a ticket                |
| [`freshdesk_tickets_get_ticket`](#freshdesk_tickets_get_ticket)                               | Get a ticket                    |
| [`freshdesk_tickets_get_ticket_form`](#freshdesk_tickets_get_ticket_form)                     | Get a ticket form               |
| [`freshdesk_tickets_get_ticket_summary`](#freshdesk_tickets_get_ticket_summary)               | Get ticket summary              |
| [`freshdesk_tickets_list_ticket_conversations`](#freshdesk_tickets_list_ticket_conversations) | List conversations for a ticket |
| [`freshdesk_tickets_list_ticket_fields`](#freshdesk_tickets_list_ticket_fields)               | List all ticket fields          |
| [`freshdesk_tickets_list_ticket_forms`](#freshdesk_tickets_list_ticket_forms)                 | List all ticket forms           |
| [`freshdesk_tickets_list_ticket_watchers`](#freshdesk_tickets_list_ticket_watchers)           | List ticket watchers            |
| [`freshdesk_tickets_list_tickets`](#freshdesk_tickets_list_tickets)                           | List all tickets                |
| [`freshdesk_tickets_merge_tickets`](#freshdesk_tickets_merge_tickets)                         | Merge tickets                   |
| [`freshdesk_tickets_reply_to_ticket`](#freshdesk_tickets_reply_to_ticket)                     | Reply to a ticket               |
| [`freshdesk_tickets_restore_ticket`](#freshdesk_tickets_restore_ticket)                       | Restore a deleted ticket        |
| [`freshdesk_tickets_search_tickets`](#freshdesk_tickets_search_tickets)                       | Search tickets                  |
| [`freshdesk_tickets_update_conversation`](#freshdesk_tickets_update_conversation)             | Update a conversation           |
| [`freshdesk_tickets_update_ticket`](#freshdesk_tickets_update_ticket)                         | Update a ticket                 |
| [`freshdesk_tickets_update_ticket_form`](#freshdesk_tickets_update_ticket_form)               | Update a ticket form            |

***

## freshdesk\_tickets\_add\_note\_to\_ticket

Add a note to a ticket

**Parameters:**

| Parameter       | Type      | Required | Default | Description                                                         |
| --------------- | --------- | -------- | ------- | ------------------------------------------------------------------- |
| `id`            | integer   | Yes      | —       | ID of the ticket to add a note to                                   |
| `body`          | string    | Yes      | —       | HTML content of the note                                            |
| `notify_emails` | string\[] | No       | —       | Array of agent email addresses to notify about this note            |
| `private`       | boolean   | No       | —       | Whether the note is private (only visible to agents). Default: true |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "ID of the ticket to add a note to"
      },
      "body": {
        "type": "string",
        "description": "HTML content of the note"
      },
      "notify_emails": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Array of agent email addresses to notify about this note"
      },
      "private": {
        "type": "boolean",
        "description": "Whether the note is private (only visible to agents). Default: true"
      }
    },
    "required": [
      "PCID",
      "id",
      "body"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_tickets\_create\_ticket

Create a ticket

**Parameters:**

| Parameter       | Type      | Required | Default | Description                                                                      |
| --------------- | --------- | -------- | ------- | -------------------------------------------------------------------------------- |
| `cc_emails`     | string\[] | No       | —       | Email addresses to CC                                                            |
| `company_id`    | integer   | No       | —       | ID of the company to associate                                                   |
| `custom_fields` | object    | No       | —       | Key-value pairs for custom fields                                                |
| `description`   | string    | Yes      | —       | HTML content of the ticket description                                           |
| `due_by`        | string    | No       | —       | Due date for the ticket                                                          |
| `email`         | string    | No       | —       | Email address of the requester. Required if requester\_id is not provided.       |
| `facebook_id`   | string    | No       | —       | Facebook ID of the requester                                                     |
| `fr_due_by`     | string    | No       | —       | First response due date                                                          |
| `group_id`      | integer   | No       | —       | ID of the group to assign the ticket to                                          |
| `phone`         | string    | No       | —       | Phone number of the requester                                                    |
| `priority`      | integer   | No       | —       | Priority: 1=Low, 2=Medium, 3=High, 4=Urgent                                      |
| `product_id`    | integer   | No       | —       | ID of the product to associate                                                   |
| `requester_id`  | integer   | No       | —       | ID of the requester contact. Required if email is not provided.                  |
| `responder_id`  | integer   | No       | —       | ID of the agent to assign the ticket to                                          |
| `source`        | integer   | No       | —       | Source: 1=Email, 2=Portal, 3=Phone, 7=Chat, 9=Feedback Widget, 10=Outbound Email |
| `status`        | integer   | No       | —       | Status: 2=Open, 3=Pending, 4=Resolved, 5=Closed                                  |
| `subject`       | string    | Yes      | —       | Subject of the ticket                                                            |
| `tags`          | string\[] | No       | —       | Tags to associate with the ticket                                                |
| `twitter_id`    | string    | No       | —       | Twitter handle of the requester                                                  |
| `type`          | string    | No       | —       | Ticket type (e.g., Question, Incident, Problem, Feature Request)                 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "cc_emails": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Email addresses to CC"
      },
      "company_id": {
        "type": "integer",
        "description": "ID of the company to associate"
      },
      "custom_fields": {
        "type": "object",
        "description": "Key-value pairs for custom fields"
      },
      "description": {
        "type": "string",
        "description": "HTML content of the ticket description"
      },
      "due_by": {
        "type": "string",
        "description": "Due date for the ticket"
      },
      "email": {
        "type": "string",
        "description": "Email address of the requester. Required if requester_id is not provided."
      },
      "facebook_id": {
        "type": "string",
        "description": "Facebook ID of the requester"
      },
      "fr_due_by": {
        "type": "string",
        "description": "First response due date"
      },
      "group_id": {
        "type": "integer",
        "description": "ID of the group to assign the ticket to"
      },
      "phone": {
        "type": "string",
        "description": "Phone number of the requester"
      },
      "priority": {
        "type": "integer",
        "description": "Priority: 1=Low, 2=Medium, 3=High, 4=Urgent",
        "enum": [
          1,
          2,
          3,
          4
        ]
      },
      "product_id": {
        "type": "integer",
        "description": "ID of the product to associate"
      },
      "requester_id": {
        "type": "integer",
        "description": "ID of the requester contact. Required if email is not provided."
      },
      "responder_id": {
        "type": "integer",
        "description": "ID of the agent to assign the ticket to"
      },
      "source": {
        "type": "integer",
        "description": "Source: 1=Email, 2=Portal, 3=Phone, 7=Chat, 9=Feedback Widget, 10=Outbound Email",
        "enum": [
          1,
          2,
          3,
          7,
          9,
          10
        ]
      },
      "status": {
        "type": "integer",
        "description": "Status: 2=Open, 3=Pending, 4=Resolved, 5=Closed",
        "enum": [
          2,
          3,
          4,
          5
        ]
      },
      "subject": {
        "type": "string",
        "description": "Subject of the ticket"
      },
      "tags": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Tags to associate with the ticket"
      },
      "twitter_id": {
        "type": "string",
        "description": "Twitter handle of the requester"
      },
      "type": {
        "type": "string",
        "description": "Ticket type (e.g., Question, Incident, Problem, Feature Request)"
      }
    },
    "required": [
      "PCID",
      "description",
      "subject"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_tickets\_create\_ticket\_form

Create a ticket form

**Parameters:**

| Parameter | Type      | Required | Default | Description                      |
| --------- | --------- | -------- | ------- | -------------------------------- |
| `fields`  | object\[] | No       | —       | Fields to include in the form    |
| `name`    | string    | Yes      | —       | Name of the ticket form          |
| `title`   | string    | No       | —       | Display title of the ticket form |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "fields": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Fields to include in the form"
      },
      "name": {
        "type": "string",
        "description": "Name of the ticket form"
      },
      "title": {
        "type": "string",
        "description": "Display title of the ticket form"
      }
    },
    "required": [
      "PCID",
      "name"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_tickets\_delete\_conversation

Delete a conversation

**Parameters:**

| Parameter | Type    | Required | Default | Description                      |
| --------- | ------- | -------- | ------- | -------------------------------- |
| `id`      | integer | Yes      | —       | ID of the conversation to delete |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "ID of the conversation to delete"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_tickets\_delete\_ticket

Delete a ticket

**Parameters:**

| Parameter | Type    | Required | Default | Description                |
| --------- | ------- | -------- | ------- | -------------------------- |
| `id`      | integer | Yes      | —       | ID of the ticket to delete |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "ID of the ticket to delete"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_tickets\_delete\_ticket\_form

Delete a ticket form

**Parameters:**

| Parameter | Type    | Required | Default | Description                     |
| --------- | ------- | -------- | ------- | ------------------------------- |
| `id`      | integer | Yes      | —       | ID of the ticket form to delete |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "ID of the ticket form to delete"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_tickets\_forward\_ticket

Forward a ticket

**Parameters:**

| Parameter    | Type      | Required | Default | Description                        |
| ------------ | --------- | -------- | ------- | ---------------------------------- |
| `id`         | integer   | Yes      | —       | ID of the ticket to forward        |
| `bcc_emails` | string\[] | No       | —       | List of BCC email addresses        |
| `body`       | string    | Yes      | —       | HTML body of the forwarded message |
| `cc_emails`  | string\[] | No       | —       | List of CC email addresses         |
| `to_emails`  | string\[] | Yes      | —       | List of recipient email addresses  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "ID of the ticket to forward"
      },
      "bcc_emails": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "List of BCC email addresses"
      },
      "body": {
        "type": "string",
        "description": "HTML body of the forwarded message"
      },
      "cc_emails": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "List of CC email addresses"
      },
      "to_emails": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "List of recipient email addresses"
      }
    },
    "required": [
      "PCID",
      "id",
      "body",
      "to_emails"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_tickets\_get\_ticket

Get a ticket

**Parameters:**

| Parameter | Type    | Required | Default | Description                                                                                            |
| --------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------ |
| `id`      | integer | Yes      | —       | ID of the ticket                                                                                       |
| `include` | string  | No       | —       | Include additional information. Comma-separated: conversations, requester, company, stats, sla\_policy |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "ID of the ticket"
      },
      "include": {
        "type": "string",
        "description": "Include additional information. Comma-separated: conversations, requester, company, stats, sla_policy"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_tickets\_get\_ticket\_form

Get a ticket form

**Parameters:**

| Parameter | Type    | Required | Default | Description           |
| --------- | ------- | -------- | ------- | --------------------- |
| `id`      | integer | Yes      | —       | ID of the ticket form |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "ID of the ticket form"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_tickets\_get\_ticket\_summary

Get ticket summary

**Parameters:**

| Parameter | Type    | Required | Default | Description      |
| --------- | ------- | -------- | ------- | ---------------- |
| `id`      | integer | Yes      | —       | ID of the ticket |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "ID of the ticket"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_tickets\_list\_ticket\_conversations

List conversations for a ticket

**Parameters:**

| Parameter  | Type    | Required | Default | Description                          |
| ---------- | ------- | -------- | ------- | ------------------------------------ |
| `id`       | integer | Yes      | —       | ID of the ticket                     |
| `page`     | integer | No       | —       | Page number for pagination           |
| `per_page` | integer | No       | —       | Number of results per page (max 100) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "ID of the ticket"
      },
      "page": {
        "type": "integer",
        "description": "Page number for pagination"
      },
      "per_page": {
        "type": "integer",
        "description": "Number of results per page (max 100)"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_tickets\_list\_ticket\_fields

List all ticket fields

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_tickets\_list\_ticket\_forms

List all ticket forms

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_tickets\_list\_ticket\_watchers

List ticket watchers

**Parameters:**

| Parameter | Type    | Required | Default | Description      |
| --------- | ------- | -------- | ------- | ---------------- |
| `id`      | integer | Yes      | —       | ID of the ticket |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "ID of the ticket"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_tickets\_list\_tickets

List all tickets

**Parameters:**

| Parameter       | Type    | Required | Default | Description                                                                             |
| --------------- | ------- | -------- | ------- | --------------------------------------------------------------------------------------- |
| `filter`        | string  | No       | —       | Pre-defined filter to use. One of: new\_and\_my\_open, watching, spam, deleted          |
| `requester_id`  | integer | No       | —       | Filter tickets by requester ID                                                          |
| `email`         | string  | No       | —       | Filter tickets by requester email                                                       |
| `company_id`    | integer | No       | —       | Filter tickets by company ID                                                            |
| `updated_since` | string  | No       | —       | Return tickets updated since this date-time (ISO 8601 format)                           |
| `order_by`      | string  | No       | —       | Field to order results by. One of: created\_at, due\_by, updated\_at, status            |
| `order_type`    | string  | No       | —       | Sort order: asc or desc                                                                 |
| `include`       | string  | No       | —       | Include additional information. Comma-separated: requester, stats, company, description |
| `page`          | integer | No       | —       | Page number for pagination (starts at 1)                                                |
| `per_page`      | integer | No       | —       | Number of results per page (max 100)                                                    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "filter": {
        "type": "string",
        "description": "Pre-defined filter to use. One of: new_and_my_open, watching, spam, deleted"
      },
      "requester_id": {
        "type": "integer",
        "description": "Filter tickets by requester ID"
      },
      "email": {
        "type": "string",
        "description": "Filter tickets by requester email"
      },
      "company_id": {
        "type": "integer",
        "description": "Filter tickets by company ID"
      },
      "updated_since": {
        "type": "string",
        "description": "Return tickets updated since this date-time (ISO 8601 format)"
      },
      "order_by": {
        "type": "string",
        "description": "Field to order results by. One of: created_at, due_by, updated_at, status"
      },
      "order_type": {
        "type": "string",
        "description": "Sort order: asc or desc",
        "enum": [
          "asc",
          "desc"
        ]
      },
      "include": {
        "type": "string",
        "description": "Include additional information. Comma-separated: requester, stats, company, description"
      },
      "page": {
        "type": "integer",
        "description": "Page number for pagination (starts at 1)"
      },
      "per_page": {
        "type": "integer",
        "description": "Number of results per page (max 100)"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_tickets\_merge\_tickets

Merge tickets

**Parameters:**

| Parameter    | Type       | Required | Default | Description                            |
| ------------ | ---------- | -------- | ------- | -------------------------------------- |
| `primary_id` | integer    | Yes      | —       | ID of the primary ticket to merge into |
| `ticket_ids` | integer\[] | Yes      | —       | IDs of secondary tickets to merge      |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "primary_id": {
        "type": "integer",
        "description": "ID of the primary ticket to merge into"
      },
      "ticket_ids": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "IDs of secondary tickets to merge"
      }
    },
    "required": [
      "PCID",
      "primary_id",
      "ticket_ids"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_tickets\_reply\_to\_ticket

Reply to a ticket

**Parameters:**

| Parameter    | Type      | Required | Default | Description                                                                              |
| ------------ | --------- | -------- | ------- | ---------------------------------------------------------------------------------------- |
| `id`         | integer   | Yes      | —       | ID of the ticket to reply to                                                             |
| `bcc_emails` | string\[] | No       | —       | Array of email addresses to BCC                                                          |
| `body`       | string    | Yes      | —       | HTML content of the reply                                                                |
| `cc_emails`  | string\[] | No       | —       | Array of email addresses to CC                                                           |
| `from_email` | string    | No       | —       | Email address from which the reply is sent. By default the global support email is used. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "ID of the ticket to reply to"
      },
      "bcc_emails": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Array of email addresses to BCC"
      },
      "body": {
        "type": "string",
        "description": "HTML content of the reply"
      },
      "cc_emails": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Array of email addresses to CC"
      },
      "from_email": {
        "type": "string",
        "description": "Email address from which the reply is sent. By default the global support email is used."
      }
    },
    "required": [
      "PCID",
      "id",
      "body"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_tickets\_restore\_ticket

Restore a deleted ticket

**Parameters:**

| Parameter | Type    | Required | Default | Description                 |
| --------- | ------- | -------- | ------- | --------------------------- |
| `id`      | integer | Yes      | —       | ID of the ticket to restore |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "ID of the ticket to restore"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_tickets\_search\_tickets

Search tickets

**Parameters:**

| Parameter | Type    | Required | Default | Description                                                                                                                                                                             |
| --------- | ------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`   | string  | Yes      | —       | Search query using Freshdesk query language. The value MUST be enclosed in double quotes, e.g. "status:2 AND priority:3". Without the surrounding quotes, the API will return an error. |
| `page`    | integer | No       | —       | Page number for pagination (starts at 1, max 10 pages)                                                                                                                                  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "query": {
        "type": "string",
        "description": "Search query using Freshdesk query language. The value MUST be enclosed in double quotes, e.g. \"status:2 AND priority:3\". Without the surrounding quotes, the API will return an error."
      },
      "page": {
        "type": "integer",
        "description": "Page number for pagination (starts at 1, max 10 pages)"
      }
    },
    "required": [
      "PCID",
      "query"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_tickets\_update\_conversation

Update a conversation

**Parameters:**

| Parameter     | Type      | Required | Default | Description                              |
| ------------- | --------- | -------- | ------- | ---------------------------------------- |
| `id`          | integer   | Yes      | —       | ID of the conversation to update         |
| `attachments` | string\[] | No       | —       | Updated attachments for the conversation |
| `body`        | string    | No       | —       | Updated HTML content of the conversation |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "ID of the conversation to update"
      },
      "attachments": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Updated attachments for the conversation"
      },
      "body": {
        "type": "string",
        "description": "Updated HTML content of the conversation"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_tickets\_update\_ticket

Update a ticket

**Parameters:**

| Parameter       | Type      | Required | Default | Description                                                                      |
| --------------- | --------- | -------- | ------- | -------------------------------------------------------------------------------- |
| `id`            | integer   | Yes      | —       | ID of the ticket to update                                                       |
| `cc_emails`     | string\[] | No       | —       | CC email addresses                                                               |
| `company_id`    | integer   | No       | —       | Company ID                                                                       |
| `custom_fields` | object    | No       | —       | Custom field key-value pairs                                                     |
| `description`   | string    | No       | —       | HTML content of the ticket description                                           |
| `due_by`        | string    | No       | —       | Due date                                                                         |
| `email`         | string    | No       | —       | Requester email                                                                  |
| `fr_due_by`     | string    | No       | —       | First response due date                                                          |
| `group_id`      | integer   | No       | —       | ID of the group to assign                                                        |
| `phone`         | string    | No       | —       | Requester phone                                                                  |
| `priority`      | integer   | No       | —       | Priority: 1=Low, 2=Medium, 3=High, 4=Urgent                                      |
| `product_id`    | integer   | No       | —       | Product ID                                                                       |
| `responder_id`  | integer   | No       | —       | ID of the agent to assign                                                        |
| `source`        | integer   | No       | —       | Source: 1=Email, 2=Portal, 3=Phone, 7=Chat, 9=Feedback Widget, 10=Outbound Email |
| `status`        | integer   | No       | —       | Status: 2=Open, 3=Pending, 4=Resolved, 5=Closed                                  |
| `subject`       | string    | No       | —       | Subject of the ticket                                                            |
| `tags`          | string\[] | No       | —       | Tags for the ticket                                                              |
| `type`          | string    | No       | —       | Ticket type                                                                      |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "ID of the ticket to update"
      },
      "cc_emails": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "CC email addresses"
      },
      "company_id": {
        "type": "integer",
        "description": "Company ID"
      },
      "custom_fields": {
        "type": "object",
        "description": "Custom field key-value pairs"
      },
      "description": {
        "type": "string",
        "description": "HTML content of the ticket description"
      },
      "due_by": {
        "type": "string",
        "description": "Due date"
      },
      "email": {
        "type": "string",
        "description": "Requester email"
      },
      "fr_due_by": {
        "type": "string",
        "description": "First response due date"
      },
      "group_id": {
        "type": "integer",
        "description": "ID of the group to assign"
      },
      "phone": {
        "type": "string",
        "description": "Requester phone"
      },
      "priority": {
        "type": "integer",
        "description": "Priority: 1=Low, 2=Medium, 3=High, 4=Urgent",
        "enum": [
          1,
          2,
          3,
          4
        ]
      },
      "product_id": {
        "type": "integer",
        "description": "Product ID"
      },
      "responder_id": {
        "type": "integer",
        "description": "ID of the agent to assign"
      },
      "source": {
        "type": "integer",
        "description": "Source: 1=Email, 2=Portal, 3=Phone, 7=Chat, 9=Feedback Widget, 10=Outbound Email",
        "enum": [
          1,
          2,
          3,
          7,
          9,
          10
        ]
      },
      "status": {
        "type": "integer",
        "description": "Status: 2=Open, 3=Pending, 4=Resolved, 5=Closed",
        "enum": [
          2,
          3,
          4,
          5
        ]
      },
      "subject": {
        "type": "string",
        "description": "Subject of the ticket"
      },
      "tags": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Tags for the ticket"
      },
      "type": {
        "type": "string",
        "description": "Ticket type"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_tickets\_update\_ticket\_form

Update a ticket form

**Parameters:**

| Parameter | Type      | Required | Default | Description                     |
| --------- | --------- | -------- | ------- | ------------------------------- |
| `id`      | integer   | Yes      | —       | ID of the ticket form to update |
| `fields`  | object\[] | No       | —       | Fields to include               |
| `name`    | string    | No       | —       | Name of the ticket form         |
| `title`   | string    | No       | —       | Display title                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "ID of the ticket form to update"
      },
      "fields": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Fields to include"
      },
      "name": {
        "type": "string",
        "description": "Name of the ticket form"
      },
      "title": {
        "type": "string",
        "description": "Display title"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>