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

> Freshdesk Admin - Agents, groups, roles, skills, automations, SLA policies, email, account settings

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

## Tools

| Tool                                                                                      | Description                           |
| ----------------------------------------------------------------------------------------- | ------------------------------------- |
| [`freshdesk_admin_create_agent`](#freshdesk_admin_create_agent)                           | Create an agent                       |
| [`freshdesk_admin_create_automation_rule`](#freshdesk_admin_create_automation_rule)       | Create an automation rule             |
| [`freshdesk_admin_create_email_mailbox`](#freshdesk_admin_create_email_mailbox)           | Create an email mailbox               |
| [`freshdesk_admin_create_group`](#freshdesk_admin_create_group)                           | Create a group                        |
| [`freshdesk_admin_create_skill`](#freshdesk_admin_create_skill)                           | Create a skill                        |
| [`freshdesk_admin_create_slapolicy`](#freshdesk_admin_create_slapolicy)                   | Create an SLA policy                  |
| [`freshdesk_admin_delete_agent`](#freshdesk_admin_delete_agent)                           | Delete an agent                       |
| [`freshdesk_admin_delete_automation_rule`](#freshdesk_admin_delete_automation_rule)       | Delete an automation rule             |
| [`freshdesk_admin_delete_email_mailbox`](#freshdesk_admin_delete_email_mailbox)           | Delete an email mailbox               |
| [`freshdesk_admin_delete_group`](#freshdesk_admin_delete_group)                           | Delete a group                        |
| [`freshdesk_admin_delete_skill`](#freshdesk_admin_delete_skill)                           | Delete a skill                        |
| [`freshdesk_admin_get_account`](#freshdesk_admin_get_account)                             | Get account details                   |
| [`freshdesk_admin_get_agent`](#freshdesk_admin_get_agent)                                 | Get an agent                          |
| [`freshdesk_admin_get_automation_rule`](#freshdesk_admin_get_automation_rule)             | Get an automation rule                |
| [`freshdesk_admin_get_current_agent`](#freshdesk_admin_get_current_agent)                 | Get the currently authenticated agent |
| [`freshdesk_admin_get_email_mailbox`](#freshdesk_admin_get_email_mailbox)                 | Get an email mailbox                  |
| [`freshdesk_admin_get_group`](#freshdesk_admin_get_group)                                 | Get a group                           |
| [`freshdesk_admin_get_helpdesk_settings`](#freshdesk_admin_get_helpdesk_settings)         | Get helpdesk settings                 |
| [`freshdesk_admin_get_job`](#freshdesk_admin_get_job)                                     | Get job status                        |
| [`freshdesk_admin_get_role`](#freshdesk_admin_get_role)                                   | Get a role                            |
| [`freshdesk_admin_get_skill`](#freshdesk_admin_get_skill)                                 | Get a skill                           |
| [`freshdesk_admin_get_slapolicy`](#freshdesk_admin_get_slapolicy)                         | Get an SLA policy                     |
| [`freshdesk_admin_list_agents`](#freshdesk_admin_list_agents)                             | List all agents                       |
| [`freshdesk_admin_list_automation_rules`](#freshdesk_admin_list_automation_rules)         | List automation rules                 |
| [`freshdesk_admin_list_business_hours`](#freshdesk_admin_list_business_hours)             | List all business hours               |
| [`freshdesk_admin_list_email_configs`](#freshdesk_admin_list_email_configs)               | List all email configurations         |
| [`freshdesk_admin_list_email_mailboxes`](#freshdesk_admin_list_email_mailboxes)           | List email mailboxes                  |
| [`freshdesk_admin_list_groups`](#freshdesk_admin_list_groups)                             | List all groups                       |
| [`freshdesk_admin_list_roles`](#freshdesk_admin_list_roles)                               | List all roles                        |
| [`freshdesk_admin_list_scenario_automations`](#freshdesk_admin_list_scenario_automations) | List scenario automations             |
| [`freshdesk_admin_list_skills`](#freshdesk_admin_list_skills)                             | List all skills                       |
| [`freshdesk_admin_list_slapolicies`](#freshdesk_admin_list_slapolicies)                   | List all SLA policies                 |
| [`freshdesk_admin_search_agents`](#freshdesk_admin_search_agents)                         | Autocomplete search for agents        |
| [`freshdesk_admin_update_agent`](#freshdesk_admin_update_agent)                           | Update an agent                       |
| [`freshdesk_admin_update_automation_rule`](#freshdesk_admin_update_automation_rule)       | Update an automation rule             |
| [`freshdesk_admin_update_email_mailbox`](#freshdesk_admin_update_email_mailbox)           | Update an email mailbox               |
| [`freshdesk_admin_update_group`](#freshdesk_admin_update_group)                           | Update a group                        |
| [`freshdesk_admin_update_skill`](#freshdesk_admin_update_skill)                           | Update a skill                        |
| [`freshdesk_admin_update_slapolicy`](#freshdesk_admin_update_slapolicy)                   | Update an SLA policy                  |

***

## freshdesk\_admin\_create\_agent

Create an agent

**Parameters:**

| Parameter      | Type       | Required | Default | Description                                    |
| -------------- | ---------- | -------- | ------- | ---------------------------------------------- |
| `email`        | string     | Yes      | —       | Email address of the agent                     |
| `group_ids`    | integer\[] | No       | —       | Group IDs the agent belongs to                 |
| `job_title`    | string     | No       | —       | Job title                                      |
| `language`     | string     | No       | —       | Language of the agent                          |
| `mobile`       | string     | No       | —       | Mobile number                                  |
| `name`         | string     | No       | —       | Full name of the agent                         |
| `occasional`   | boolean    | No       | —       | Whether this is an occasional (day pass) agent |
| `phone`        | string     | No       | —       | Phone number                                   |
| `role_ids`     | integer\[] | No       | —       | Role IDs assigned to the agent                 |
| `signature`    | string     | No       | —       | Agent's email signature in HTML                |
| `skill_ids`    | integer\[] | No       | —       | Skill IDs assigned to the agent                |
| `ticket_scope` | integer    | Yes      | —       | Ticket scope: 1=Global, 2=Group, 3=Restricted  |
| `time_zone`    | string     | No       | —       | Timezone of the agent                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "email": {
        "type": "string",
        "description": "Email address of the agent"
      },
      "group_ids": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "Group IDs the agent belongs to"
      },
      "job_title": {
        "type": "string",
        "description": "Job title"
      },
      "language": {
        "type": "string",
        "description": "Language of the agent"
      },
      "mobile": {
        "type": "string",
        "description": "Mobile number"
      },
      "name": {
        "type": "string",
        "description": "Full name of the agent"
      },
      "occasional": {
        "type": "boolean",
        "description": "Whether this is an occasional (day pass) agent"
      },
      "phone": {
        "type": "string",
        "description": "Phone number"
      },
      "role_ids": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "Role IDs assigned to the agent"
      },
      "signature": {
        "type": "string",
        "description": "Agent's email signature in HTML"
      },
      "skill_ids": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "Skill IDs assigned to the agent"
      },
      "ticket_scope": {
        "type": "integer",
        "description": "Ticket scope: 1=Global, 2=Group, 3=Restricted"
      },
      "time_zone": {
        "type": "string",
        "description": "Timezone of the agent"
      }
    },
    "required": [
      "PCID",
      "email",
      "ticket_scope"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_create\_automation\_rule

Create an automation rule

**Parameters:**

| Parameter            | Type      | Required | Default | Description                                                                                    |
| -------------------- | --------- | -------- | ------- | ---------------------------------------------------------------------------------------------- |
| `automation_type_id` | integer   | Yes      | —       | Type of automation: 1=Ticket Creation, 2=Time Triggers, 3=Ticket Update, 4=Email Notifications |
| `actions`            | object\[] | No       | —       | Actions when rule triggers                                                                     |
| `active`             | boolean   | No       | —       | Whether the rule is active                                                                     |
| `conditions`         | object\[] | No       | —       | Conditions for the rule                                                                        |
| `description`        | string    | No       | —       | Description of the rule                                                                        |
| `events`             | object\[] | No       | —       | Trigger events                                                                                 |
| `name`               | string    | Yes      | —       | Name of the rule                                                                               |
| `performer`          | object    | No       | —       | Who triggers the rule                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "automation_type_id": {
        "type": "integer",
        "description": "Type of automation: 1=Ticket Creation, 2=Time Triggers, 3=Ticket Update, 4=Email Notifications",
        "enum": [
          1,
          2,
          3,
          4
        ]
      },
      "actions": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Actions when rule triggers"
      },
      "active": {
        "type": "boolean",
        "description": "Whether the rule is active"
      },
      "conditions": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Conditions for the rule"
      },
      "description": {
        "type": "string",
        "description": "Description of the rule"
      },
      "events": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Trigger events"
      },
      "name": {
        "type": "string",
        "description": "Name of the rule"
      },
      "performer": {
        "type": "object",
        "description": "Who triggers the rule"
      }
    },
    "required": [
      "PCID",
      "automation_type_id",
      "name"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_create\_email\_mailbox

Create an email mailbox

**Parameters:**

| Parameter       | Type    | Required | Default | Description           |
| --------------- | ------- | -------- | ------- | --------------------- |
| `group_id`      | integer | No       | —       | Default group ID      |
| `name`          | string  | Yes      | —       | Name of the mailbox   |
| `product_id`    | integer | No       | —       | Associated product ID |
| `support_email` | string  | Yes      | —       | Support email address |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "group_id": {
        "type": "integer",
        "description": "Default group ID"
      },
      "name": {
        "type": "string",
        "description": "Name of the mailbox"
      },
      "product_id": {
        "type": "integer",
        "description": "Associated product ID"
      },
      "support_email": {
        "type": "string",
        "description": "Support email address"
      }
    },
    "required": [
      "PCID",
      "name",
      "support_email"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_create\_group

Create a group

**Parameters:**

| Parameter            | Type       | Required | Default | Description                                |
| -------------------- | ---------- | -------- | ------- | ------------------------------------------ |
| `agent_ids`          | integer\[] | No       | —       | IDs of agents to add to the group          |
| `auto_ticket_assign` | integer    | No       | —       | Auto assignment: 0=Disabled, 1=Round Robin |
| `business_hour_id`   | integer    | No       | —       | Business hour schedule ID                  |
| `description`        | string     | No       | —       | The description value                      |
| `escalate_to`        | integer    | No       | —       | Agent ID to escalate to                    |
| `name`               | string     | Yes      | —       | Name of the group                          |
| `unassigned_for`     | string     | No       | —       | Time duration for unassigned escalation    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "agent_ids": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "IDs of agents to add to the group"
      },
      "auto_ticket_assign": {
        "type": "integer",
        "description": "Auto assignment: 0=Disabled, 1=Round Robin"
      },
      "business_hour_id": {
        "type": "integer",
        "description": "Business hour schedule ID"
      },
      "description": {
        "type": "string",
        "description": "The description value"
      },
      "escalate_to": {
        "type": "integer",
        "description": "Agent ID to escalate to"
      },
      "name": {
        "type": "string",
        "description": "Name of the group"
      },
      "unassigned_for": {
        "type": "string",
        "description": "Time duration for unassigned escalation"
      }
    },
    "required": [
      "PCID",
      "name"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_create\_skill

Create a skill

**Parameters:**

| Parameter    | Type      | Required | Default | Description                |
| ------------ | --------- | -------- | ------- | -------------------------- |
| `agents`     | object\[] | No       | —       | Agents with this skill     |
| `conditions` | object\[] | No       | —       | Match conditions           |
| `name`       | string    | Yes      | —       | Name of the skill          |
| `rank`       | integer   | No       | —       | Rank/priority of the skill |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "agents": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Agents with this skill"
      },
      "conditions": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Match conditions"
      },
      "name": {
        "type": "string",
        "description": "Name of the skill"
      },
      "rank": {
        "type": "integer",
        "description": "Rank/priority of the skill"
      }
    },
    "required": [
      "PCID",
      "name"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_create\_slapolicy

Create an SLA policy

**Parameters:**

| Parameter       | Type    | Required | Default | Description                               |
| --------------- | ------- | -------- | ------- | ----------------------------------------- |
| `active`        | boolean | No       | —       | Whether the SLA policy is active          |
| `applicable_to` | object  | No       | —       | Conditions for when this SLA applies      |
| `description`   | string  | No       | —       | Description of the SLA policy             |
| `escalation`    | object  | No       | —       | Escalation settings                       |
| `name`          | string  | Yes      | —       | Name of the SLA policy                    |
| `sla_target`    | object  | No       | —       | SLA targets for different priority levels |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "active": {
        "type": "boolean",
        "description": "Whether the SLA policy is active"
      },
      "applicable_to": {
        "type": "object",
        "description": "Conditions for when this SLA applies"
      },
      "description": {
        "type": "string",
        "description": "Description of the SLA policy"
      },
      "escalation": {
        "type": "object",
        "description": "Escalation settings"
      },
      "name": {
        "type": "string",
        "description": "Name of the SLA policy"
      },
      "sla_target": {
        "type": "object",
        "description": "SLA targets for different priority levels"
      }
    },
    "required": [
      "PCID",
      "name"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_delete\_agent

Delete an agent

**Parameters:**

| Parameter | Type    | Required | Default | Description               |
| --------- | ------- | -------- | ------- | ------------------------- |
| `id`      | integer | Yes      | —       | ID of the agent 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 agent to delete"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_delete\_automation\_rule

Delete an automation rule

**Parameters:**

| Parameter            | Type    | Required | Default | Description                                                                                    |
| -------------------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------- |
| `automation_type_id` | integer | Yes      | —       | Type of automation: 1=Ticket Creation, 2=Time Triggers, 3=Ticket Update, 4=Email Notifications |
| `id`                 | integer | Yes      | —       | ID of the automation rule to delete                                                            |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "automation_type_id": {
        "type": "integer",
        "description": "Type of automation: 1=Ticket Creation, 2=Time Triggers, 3=Ticket Update, 4=Email Notifications",
        "enum": [
          1,
          2,
          3,
          4
        ]
      },
      "id": {
        "type": "integer",
        "description": "ID of the automation rule to delete"
      }
    },
    "required": [
      "PCID",
      "automation_type_id",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_delete\_email\_mailbox

Delete an email mailbox

**Parameters:**

| Parameter | Type    | Required | Default | Description                       |
| --------- | ------- | -------- | ------- | --------------------------------- |
| `id`      | integer | Yes      | —       | ID of the email mailbox 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 email mailbox to delete"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_delete\_group

Delete a group

**Parameters:**

| Parameter | Type    | Required | Default | Description               |
| --------- | ------- | -------- | ------- | ------------------------- |
| `id`      | integer | Yes      | —       | ID of the group 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 group to delete"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_delete\_skill

Delete a skill

**Parameters:**

| Parameter | Type    | Required | Default | Description               |
| --------- | ------- | -------- | ------- | ------------------------- |
| `id`      | integer | Yes      | —       | ID of the skill 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 skill to delete"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_get\_account

Get account details

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

***

## freshdesk\_admin\_get\_agent

Get an agent

**Parameters:**

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

<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 agent"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_get\_automation\_rule

Get an automation rule

**Parameters:**

| Parameter            | Type    | Required | Default | Description                                                                                    |
| -------------------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------- |
| `automation_type_id` | integer | Yes      | —       | Type of automation: 1=Ticket Creation, 2=Time Triggers, 3=Ticket Update, 4=Email Notifications |
| `id`                 | integer | Yes      | —       | ID of the automation rule                                                                      |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "automation_type_id": {
        "type": "integer",
        "description": "Type of automation: 1=Ticket Creation, 2=Time Triggers, 3=Ticket Update, 4=Email Notifications",
        "enum": [
          1,
          2,
          3,
          4
        ]
      },
      "id": {
        "type": "integer",
        "description": "ID of the automation rule"
      }
    },
    "required": [
      "PCID",
      "automation_type_id",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_get\_current\_agent

Get the currently authenticated agent

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

***

## freshdesk\_admin\_get\_email\_mailbox

Get an email mailbox

**Parameters:**

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

<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 email mailbox"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_get\_group

Get a group

**Parameters:**

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

<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 group"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_get\_helpdesk\_settings

Get helpdesk settings

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

***

## freshdesk\_admin\_get\_job

Get job status

**Parameters:**

| Parameter | Type   | Required | Default | Description              |
| --------- | ------ | -------- | ------- | ------------------------ |
| `id`      | string | Yes      | —       | ID of the background job |

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

***

## freshdesk\_admin\_get\_role

Get a role

**Parameters:**

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

<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 role"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_get\_skill

Get a skill

**Parameters:**

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

<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 skill"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_get\_slapolicy

Get an SLA policy

**Parameters:**

| Parameter | Type    | Required | Default | Description          |
| --------- | ------- | -------- | ------- | -------------------- |
| `id`      | integer | Yes      | —       | ID of the 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 SLA policy"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_list\_agents

List all agents

**Parameters:**

| Parameter  | Type    | Required | Default | Description                           |
| ---------- | ------- | -------- | ------- | ------------------------------------- |
| `email`    | string  | No       | —       | Filter by agent email address         |
| `mobile`   | string  | No       | —       | Filter by mobile number               |
| `phone`    | string  | No       | —       | Filter by phone number                |
| `state`    | string  | No       | —       | Filter by state: fulltime, occasional |
| `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"
      },
      "email": {
        "type": "string",
        "description": "Filter by agent email address"
      },
      "mobile": {
        "type": "string",
        "description": "Filter by mobile number"
      },
      "phone": {
        "type": "string",
        "description": "Filter by phone number"
      },
      "state": {
        "type": "string",
        "description": "Filter by state: fulltime, occasional"
      },
      "page": {
        "type": "integer",
        "description": "Page number for pagination"
      },
      "per_page": {
        "type": "integer",
        "description": "Number of results per page (max 100)"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_list\_automation\_rules

List automation rules

**Parameters:**

| Parameter            | Type    | Required | Default | Description                                                                                    |
| -------------------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------- |
| `automation_type_id` | integer | Yes      | —       | Type of automation: 1=Ticket Creation, 2=Time Triggers, 3=Ticket Update, 4=Email Notifications |
| `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"
      },
      "automation_type_id": {
        "type": "integer",
        "description": "Type of automation: 1=Ticket Creation, 2=Time Triggers, 3=Ticket Update, 4=Email Notifications",
        "enum": [
          1,
          2,
          3,
          4
        ]
      },
      "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",
      "automation_type_id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_list\_business\_hours

List all business hours

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

***

## freshdesk\_admin\_list\_email\_configs

List all email configurations

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

***

## freshdesk\_admin\_list\_email\_mailboxes

List email mailboxes

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

***

## freshdesk\_admin\_list\_groups

List all groups

**Parameters:**

| Parameter  | Type    | Required | Default | Description                          |
| ---------- | ------- | -------- | ------- | ------------------------------------ |
| `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"
      },
      "page": {
        "type": "integer",
        "description": "Page number for pagination"
      },
      "per_page": {
        "type": "integer",
        "description": "Number of results per page (max 100)"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_list\_roles

List all roles

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

***

## freshdesk\_admin\_list\_scenario\_automations

List scenario automations

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

***

## freshdesk\_admin\_list\_skills

List all skills

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

***

## freshdesk\_admin\_list\_slapolicies

List all SLA policies

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

***

## freshdesk\_admin\_search\_agents

Autocomplete search for agents

**Parameters:**

| Parameter | Type   | Required | Default | Description                                      |
| --------- | ------ | -------- | ------- | ------------------------------------------------ |
| `term`    | string | Yes      | —       | Search term to match against agent name or email |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "term": {
        "type": "string",
        "description": "Search term to match against agent name or email"
      }
    },
    "required": [
      "PCID",
      "term"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_update\_agent

Update an agent

**Parameters:**

| Parameter      | Type       | Required | Default | Description                                          |
| -------------- | ---------- | -------- | ------- | ---------------------------------------------------- |
| `id`           | integer    | Yes      | —       | ID of the agent to update                            |
| `email`        | string     | No       | —       | Email address                                        |
| `group_ids`    | integer\[] | No       | —       | Group IDs to assign                                  |
| `job_title`    | string     | No       | —       | Job title                                            |
| `language`     | string     | No       | —       | Language preference                                  |
| `mobile`       | string     | No       | —       | Mobile number                                        |
| `name`         | string     | No       | —       | Name of the agent                                    |
| `occasional`   | boolean    | No       | —       | Whether this is an occasional agent                  |
| `phone`        | string     | No       | —       | Phone number                                         |
| `role_ids`     | integer\[] | No       | —       | Role IDs to assign                                   |
| `signature`    | string     | No       | —       | HTML signature                                       |
| `ticket_scope` | integer    | No       | —       | Ticket access scope: 1=Global, 2=Group, 3=Restricted |
| `time_zone`    | string     | No       | —       | Timezone                                             |

<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 agent to update"
      },
      "email": {
        "type": "string",
        "description": "Email address"
      },
      "group_ids": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "Group IDs to assign"
      },
      "job_title": {
        "type": "string",
        "description": "Job title"
      },
      "language": {
        "type": "string",
        "description": "Language preference"
      },
      "mobile": {
        "type": "string",
        "description": "Mobile number"
      },
      "name": {
        "type": "string",
        "description": "Name of the agent"
      },
      "occasional": {
        "type": "boolean",
        "description": "Whether this is an occasional agent"
      },
      "phone": {
        "type": "string",
        "description": "Phone number"
      },
      "role_ids": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "Role IDs to assign"
      },
      "signature": {
        "type": "string",
        "description": "HTML signature"
      },
      "ticket_scope": {
        "type": "integer",
        "description": "Ticket access scope: 1=Global, 2=Group, 3=Restricted"
      },
      "time_zone": {
        "type": "string",
        "description": "Timezone"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_update\_automation\_rule

Update an automation rule

**Parameters:**

| Parameter            | Type      | Required | Default | Description                                                                                    |
| -------------------- | --------- | -------- | ------- | ---------------------------------------------------------------------------------------------- |
| `automation_type_id` | integer   | Yes      | —       | Type of automation: 1=Ticket Creation, 2=Time Triggers, 3=Ticket Update, 4=Email Notifications |
| `id`                 | integer   | Yes      | —       | ID of the automation rule to update                                                            |
| `actions`            | object\[] | No       | —       | Actions when rule triggers                                                                     |
| `active`             | boolean   | No       | —       | Whether the rule is active                                                                     |
| `conditions`         | object\[] | No       | —       | Conditions for the rule                                                                        |
| `description`        | string    | No       | —       | Description of the rule                                                                        |
| `events`             | object\[] | No       | —       | Trigger events                                                                                 |
| `name`               | string    | No       | —       | Name of the rule                                                                               |
| `performer`          | object    | No       | —       | Who triggers the rule                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "automation_type_id": {
        "type": "integer",
        "description": "Type of automation: 1=Ticket Creation, 2=Time Triggers, 3=Ticket Update, 4=Email Notifications",
        "enum": [
          1,
          2,
          3,
          4
        ]
      },
      "id": {
        "type": "integer",
        "description": "ID of the automation rule to update"
      },
      "actions": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Actions when rule triggers"
      },
      "active": {
        "type": "boolean",
        "description": "Whether the rule is active"
      },
      "conditions": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Conditions for the rule"
      },
      "description": {
        "type": "string",
        "description": "Description of the rule"
      },
      "events": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Trigger events"
      },
      "name": {
        "type": "string",
        "description": "Name of the rule"
      },
      "performer": {
        "type": "object",
        "description": "Who triggers the rule"
      }
    },
    "required": [
      "PCID",
      "automation_type_id",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_update\_email\_mailbox

Update an email mailbox

**Parameters:**

| Parameter       | Type    | Required | Default | Description                       |
| --------------- | ------- | -------- | ------- | --------------------------------- |
| `id`            | integer | Yes      | —       | ID of the email mailbox to update |
| `group_id`      | integer | No       | —       | Default group ID                  |
| `name`          | string  | No       | —       | Name of the mailbox               |
| `product_id`    | integer | No       | —       | Associated product ID             |
| `support_email` | string  | No       | —       | Support email address             |

<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 email mailbox to update"
      },
      "group_id": {
        "type": "integer",
        "description": "Default group ID"
      },
      "name": {
        "type": "string",
        "description": "Name of the mailbox"
      },
      "product_id": {
        "type": "integer",
        "description": "Associated product ID"
      },
      "support_email": {
        "type": "string",
        "description": "Support email address"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_update\_group

Update a group

**Parameters:**

| Parameter            | Type       | Required | Default | Description                                |
| -------------------- | ---------- | -------- | ------- | ------------------------------------------ |
| `id`                 | integer    | Yes      | —       | ID of the group to update                  |
| `agent_ids`          | integer\[] | No       | —       | Agent IDs                                  |
| `auto_ticket_assign` | integer    | No       | —       | Auto assignment: 0=Disabled, 1=Round Robin |
| `business_hour_id`   | integer    | No       | —       | Business hour schedule ID                  |
| `description`        | string     | No       | —       | The description value                      |
| `escalate_to`        | integer    | No       | —       | Agent ID to escalate to                    |
| `name`               | string     | No       | —       | Name of the group                          |
| `unassigned_for`     | string     | No       | —       | Time duration for unassigned escalation    |

<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 group to update"
      },
      "agent_ids": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "Agent IDs"
      },
      "auto_ticket_assign": {
        "type": "integer",
        "description": "Auto assignment: 0=Disabled, 1=Round Robin"
      },
      "business_hour_id": {
        "type": "integer",
        "description": "Business hour schedule ID"
      },
      "description": {
        "type": "string",
        "description": "The description value"
      },
      "escalate_to": {
        "type": "integer",
        "description": "Agent ID to escalate to"
      },
      "name": {
        "type": "string",
        "description": "Name of the group"
      },
      "unassigned_for": {
        "type": "string",
        "description": "Time duration for unassigned escalation"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_update\_skill

Update a skill

**Parameters:**

| Parameter    | Type      | Required | Default | Description               |
| ------------ | --------- | -------- | ------- | ------------------------- |
| `id`         | integer   | Yes      | —       | ID of the skill to update |
| `agents`     | object\[] | No       | —       | Agents with this skill    |
| `conditions` | object\[] | No       | —       | Match conditions          |
| `name`       | string    | No       | —       | Name of the skill         |
| `rank`       | integer   | No       | —       | Rank/priority             |

<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 skill to update"
      },
      "agents": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Agents with this skill"
      },
      "conditions": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Match conditions"
      },
      "name": {
        "type": "string",
        "description": "Name of the skill"
      },
      "rank": {
        "type": "integer",
        "description": "Rank/priority"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## freshdesk\_admin\_update\_slapolicy

Update an SLA policy

**Parameters:**

| Parameter       | Type    | Required | Default | Description                               |
| --------------- | ------- | -------- | ------- | ----------------------------------------- |
| `id`            | integer | Yes      | —       | ID of the SLA policy to update            |
| `active`        | boolean | No       | —       | Whether the SLA policy is active          |
| `applicable_to` | object  | No       | —       | Conditions for when this SLA applies      |
| `description`   | string  | No       | —       | Description of the SLA policy             |
| `escalation`    | object  | No       | —       | Escalation settings                       |
| `name`          | string  | No       | —       | Name of the SLA policy                    |
| `sla_target`    | object  | No       | —       | SLA targets for different priority levels |

<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 SLA policy to update"
      },
      "active": {
        "type": "boolean",
        "description": "Whether the SLA policy is active"
      },
      "applicable_to": {
        "type": "object",
        "description": "Conditions for when this SLA applies"
      },
      "description": {
        "type": "string",
        "description": "Description of the SLA policy"
      },
      "escalation": {
        "type": "object",
        "description": "Escalation settings"
      },
      "name": {
        "type": "string",
        "description": "Name of the SLA policy"
      },
      "sla_target": {
        "type": "object",
        "description": "SLA targets for different priority levels"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>
