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

> Freshservice People — manage agents, requesters, groups, roles, departments, and locations

**Server path:** `/freshservice-people` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                                      | Description                        |
| --------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| [`freshservice_people_add_requester_group_member`](#freshservice_people_add_requester_group_member)       | Add Member to Requester Group      |
| [`freshservice_people_create_agent`](#freshservice_people_create_agent)                                   | Create an Agent                    |
| [`freshservice_people_create_agent_group`](#freshservice_people_create_agent_group)                       | Create an Agent Group              |
| [`freshservice_people_create_department`](#freshservice_people_create_department)                         | Create a Department                |
| [`freshservice_people_create_location`](#freshservice_people_create_location)                             | Create a Location                  |
| [`freshservice_people_create_requester`](#freshservice_people_create_requester)                           | Create a Requester                 |
| [`freshservice_people_create_requester_group`](#freshservice_people_create_requester_group)               | Create a Requester Group           |
| [`freshservice_people_deactivate_agent`](#freshservice_people_deactivate_agent)                           | Deactivate an Agent                |
| [`freshservice_people_deactivate_requester`](#freshservice_people_deactivate_requester)                   | Deactivate a Requester             |
| [`freshservice_people_delete_agent_group`](#freshservice_people_delete_agent_group)                       | Delete an Agent Group              |
| [`freshservice_people_delete_department`](#freshservice_people_delete_department)                         | Delete a Department                |
| [`freshservice_people_delete_location`](#freshservice_people_delete_location)                             | Delete a Location                  |
| [`freshservice_people_delete_requester_group`](#freshservice_people_delete_requester_group)               | Delete a Requester Group           |
| [`freshservice_people_get_agent`](#freshservice_people_get_agent)                                         | View an Agent                      |
| [`freshservice_people_get_agent_group`](#freshservice_people_get_agent_group)                             | View an Agent Group                |
| [`freshservice_people_get_department`](#freshservice_people_get_department)                               | View a Department                  |
| [`freshservice_people_get_location`](#freshservice_people_get_location)                                   | View a Location                    |
| [`freshservice_people_get_requester`](#freshservice_people_get_requester)                                 | View a Requester                   |
| [`freshservice_people_get_requester_group`](#freshservice_people_get_requester_group)                     | View a Requester Group             |
| [`freshservice_people_get_role`](#freshservice_people_get_role)                                           | View a Role                        |
| [`freshservice_people_list_agent_fields`](#freshservice_people_list_agent_fields)                         | List All Agent Fields              |
| [`freshservice_people_list_agent_groups`](#freshservice_people_list_agent_groups)                         | List All Agent Groups              |
| [`freshservice_people_list_agents`](#freshservice_people_list_agents)                                     | List All Agents                    |
| [`freshservice_people_list_department_fields`](#freshservice_people_list_department_fields)               | List All Department Fields         |
| [`freshservice_people_list_departments`](#freshservice_people_list_departments)                           | List All Departments               |
| [`freshservice_people_list_locations`](#freshservice_people_list_locations)                               | List All Locations                 |
| [`freshservice_people_list_requester_fields`](#freshservice_people_list_requester_fields)                 | List All Requester Fields          |
| [`freshservice_people_list_requester_group_members`](#freshservice_people_list_requester_group_members)   | List Requester Group Members       |
| [`freshservice_people_list_requester_groups`](#freshservice_people_list_requester_groups)                 | List All Requester Groups          |
| [`freshservice_people_list_requesters`](#freshservice_people_list_requesters)                             | List All Requesters                |
| [`freshservice_people_list_roles`](#freshservice_people_list_roles)                                       | List All Roles                     |
| [`freshservice_people_merge_requesters`](#freshservice_people_merge_requesters)                           | Merge Requesters                   |
| [`freshservice_people_reactivate_agent`](#freshservice_people_reactivate_agent)                           | Reactivate an Agent                |
| [`freshservice_people_reactivate_requester`](#freshservice_people_reactivate_requester)                   | Reactivate a Requester             |
| [`freshservice_people_remove_requester_group_member`](#freshservice_people_remove_requester_group_member) | Remove Member from Requester Group |
| [`freshservice_people_update_agent`](#freshservice_people_update_agent)                                   | Update an Agent                    |
| [`freshservice_people_update_agent_group`](#freshservice_people_update_agent_group)                       | Update an Agent Group              |
| [`freshservice_people_update_department`](#freshservice_people_update_department)                         | Update a Department                |
| [`freshservice_people_update_location`](#freshservice_people_update_location)                             | Update a Location                  |
| [`freshservice_people_update_requester`](#freshservice_people_update_requester)                           | Update a Requester                 |
| [`freshservice_people_update_requester_group`](#freshservice_people_update_requester_group)               | Update a Requester Group           |

***

## freshservice\_people\_add\_requester\_group\_member

Add Member to Requester Group

**Parameters:**

| Parameter            | Type    | Required | Default | Description  |
| -------------------- | ------- | -------- | ------- | ------------ |
| `requester_group_id` | integer | Yes      | —       | Group ID     |
| `requester_id`       | integer | Yes      | —       | Requester ID |

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

***

## freshservice\_people\_create\_agent

Create an Agent

**Parameters:**

| Parameter              | Type       | Required | Default | Description      |
| ---------------------- | ---------- | -------- | ------- | ---------------- |
| `custom_fields`        | object     | No       | —       | Custom fields    |
| `department_ids`       | integer\[] | No       | —       | Department IDs   |
| `email`                | string     | Yes      | —       | Email (required) |
| `first_name`           | string     | No       | —       | First name       |
| `job_title`            | string     | No       | —       | Job title        |
| `last_name`            | string     | No       | —       | Last name        |
| `location_id`          | integer    | No       | —       | Location ID      |
| `mobile_phone_number`  | string     | No       | —       | Mobile phone     |
| `occasional`           | boolean    | No       | —       | Occasional agent |
| `reporting_manager_id` | integer    | No       | —       | Manager ID       |
| `roles`                | object\[]  | No       | —       | Role assignments |
| `work_phone_number`    | string     | No       | —       | Work phone       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "custom_fields": {
        "type": "object",
        "description": "Custom fields"
      },
      "department_ids": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "Department IDs"
      },
      "email": {
        "type": "string",
        "description": "Email (required)"
      },
      "first_name": {
        "type": "string",
        "description": "First name"
      },
      "job_title": {
        "type": "string",
        "description": "Job title"
      },
      "last_name": {
        "type": "string",
        "description": "Last name"
      },
      "location_id": {
        "type": "integer",
        "description": "Location ID"
      },
      "mobile_phone_number": {
        "type": "string",
        "description": "Mobile phone"
      },
      "occasional": {
        "type": "boolean",
        "description": "Occasional agent"
      },
      "reporting_manager_id": {
        "type": "integer",
        "description": "Manager ID"
      },
      "roles": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Role assignments"
      },
      "work_phone_number": {
        "type": "string",
        "description": "Work phone"
      }
    },
    "required": [
      "PCID",
      "email"
    ]
  }
  ```
</Expandable>

***

## freshservice\_people\_create\_agent\_group

Create an Agent Group

**Parameters:**

| Parameter           | Type       | Required | Default | Description           |
| ------------------- | ---------- | -------- | ------- | --------------------- |
| `business_hours_id` | integer    | No       | —       | Business hours config |
| `description`       | string     | No       | —       | The description value |
| `escalate_to`       | integer    | No       | —       | Escalation user ID    |
| `leaders`           | integer\[] | No       | —       | Leader agent IDs      |
| `members`           | integer\[] | No       | —       | Member agent IDs      |
| `name`              | string     | Yes      | —       | Group name            |
| `observers`         | integer\[] | No       | —       | Observer agent IDs    |
| `unassigned_for`    | string     | No       | —       | Escalation threshold  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "business_hours_id": {
        "type": "integer",
        "description": "Business hours config"
      },
      "description": {
        "type": "string",
        "description": "The description value"
      },
      "escalate_to": {
        "type": "integer",
        "description": "Escalation user ID"
      },
      "leaders": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "Leader agent IDs"
      },
      "members": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "Member agent IDs"
      },
      "name": {
        "type": "string",
        "description": "Group name"
      },
      "observers": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "Observer agent IDs"
      },
      "unassigned_for": {
        "type": "string",
        "description": "Escalation threshold"
      }
    },
    "required": [
      "PCID",
      "name"
    ]
  }
  ```
</Expandable>

***

## freshservice\_people\_create\_department

Create a Department

**Parameters:**

| Parameter       | Type      | Required | Default | Description             |
| --------------- | --------- | -------- | ------- | ----------------------- |
| `custom_fields` | object    | No       | —       | Custom fields           |
| `description`   | string    | No       | —       | The description value   |
| `domains`       | string\[] | No       | —       | Email domains           |
| `head_user_id`  | integer   | No       | —       | Department head user ID |
| `name`          | string    | Yes      | —       | The name value          |
| `prime_user_id` | integer   | No       | —       | Prime user ID           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "custom_fields": {
        "type": "object",
        "description": "Custom fields"
      },
      "description": {
        "type": "string",
        "description": "The description value"
      },
      "domains": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Email domains"
      },
      "head_user_id": {
        "type": "integer",
        "description": "Department head user ID"
      },
      "name": {
        "type": "string",
        "description": "The name value"
      },
      "prime_user_id": {
        "type": "integer",
        "description": "Prime user ID"
      }
    },
    "required": [
      "PCID",
      "name"
    ]
  }
  ```
</Expandable>

***

## freshservice\_people\_create\_location

Create a Location

**Parameters:**

| Parameter            | Type    | Required | Default | Description             |
| -------------------- | ------- | -------- | ------- | ----------------------- |
| `city`               | string  | No       | —       | The city value          |
| `country`            | string  | No       | —       | The country value       |
| `email`              | string  | No       | —       | Contact email           |
| `line1`              | string  | No       | —       | Address line 1          |
| `line2`              | string  | No       | —       | Address line 2          |
| `name`               | string  | Yes      | —       | The name value          |
| `parent_location_id` | integer | No       | —       | Parent location ID      |
| `phone`              | string  | No       | —       | Contact phone           |
| `primary_contact_id` | integer | No       | —       | Primary contact user ID |
| `state`              | string  | No       | —       | The state value         |
| `zipcode`            | string  | No       | —       | Zip code                |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "city": {
        "type": "string",
        "description": "The city value"
      },
      "country": {
        "type": "string",
        "description": "The country value"
      },
      "email": {
        "type": "string",
        "description": "Contact email"
      },
      "line1": {
        "type": "string",
        "description": "Address line 1"
      },
      "line2": {
        "type": "string",
        "description": "Address line 2"
      },
      "name": {
        "type": "string",
        "description": "The name value"
      },
      "parent_location_id": {
        "type": "integer",
        "description": "Parent location ID"
      },
      "phone": {
        "type": "string",
        "description": "Contact phone"
      },
      "primary_contact_id": {
        "type": "integer",
        "description": "Primary contact user ID"
      },
      "state": {
        "type": "string",
        "description": "The state value"
      },
      "zipcode": {
        "type": "string",
        "description": "Zip code"
      }
    },
    "required": [
      "PCID",
      "name"
    ]
  }
  ```
</Expandable>

***

## freshservice\_people\_create\_requester

Create a Requester

**Parameters:**

| Parameter                | Type       | Required | Default | Description       |
| ------------------------ | ---------- | -------- | ------- | ----------------- |
| `background_information` | string     | No       | —       | Background info   |
| `custom_fields`          | object     | No       | —       | Custom fields     |
| `department_ids`         | integer\[] | No       | —       | Department IDs    |
| `first_name`             | string     | Yes      | —       | First name        |
| `job_title`              | string     | No       | —       | Job title         |
| `last_name`              | string     | No       | —       | Last name         |
| `location_id`            | integer    | No       | —       | Location ID       |
| `mobile_phone_number`    | string     | No       | —       | Mobile phone      |
| `primary_email`          | string     | No       | —       | Primary email     |
| `reporting_manager_id`   | integer    | No       | —       | Manager ID        |
| `secondary_emails`       | string\[]  | No       | —       | Additional emails |
| `work_phone_number`      | string     | No       | —       | Work phone        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "background_information": {
        "type": "string",
        "description": "Background info"
      },
      "custom_fields": {
        "type": "object",
        "description": "Custom fields"
      },
      "department_ids": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "Department IDs"
      },
      "first_name": {
        "type": "string",
        "description": "First name"
      },
      "job_title": {
        "type": "string",
        "description": "Job title"
      },
      "last_name": {
        "type": "string",
        "description": "Last name"
      },
      "location_id": {
        "type": "integer",
        "description": "Location ID"
      },
      "mobile_phone_number": {
        "type": "string",
        "description": "Mobile phone"
      },
      "primary_email": {
        "type": "string",
        "description": "Primary email"
      },
      "reporting_manager_id": {
        "type": "integer",
        "description": "Manager ID"
      },
      "secondary_emails": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Additional emails"
      },
      "work_phone_number": {
        "type": "string",
        "description": "Work phone"
      }
    },
    "required": [
      "PCID",
      "first_name"
    ]
  }
  ```
</Expandable>

***

## freshservice\_people\_create\_requester\_group

Create a Requester Group

**Parameters:**

| Parameter     | Type   | Required | Default | Description           |
| ------------- | ------ | -------- | ------- | --------------------- |
| `description` | string | No       | —       | The description value |
| `name`        | string | Yes      | —       | Group name            |

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

***

## freshservice\_people\_deactivate\_agent

Deactivate an Agent

**Parameters:**

| Parameter  | Type    | Required | Default | Description |
| ---------- | ------- | -------- | ------- | ----------- |
| `agent_id` | integer | Yes      | —       | Agent ID    |

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

***

## freshservice\_people\_deactivate\_requester

Deactivate a Requester

**Parameters:**

| Parameter      | Type    | Required | Default | Description  |
| -------------- | ------- | -------- | ------- | ------------ |
| `requester_id` | integer | Yes      | —       | Requester ID |

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

***

## freshservice\_people\_delete\_agent\_group

Delete an Agent Group

**Parameters:**

| Parameter  | Type    | Required | Default | Description |
| ---------- | ------- | -------- | ------- | ----------- |
| `group_id` | integer | Yes      | —       | Group ID    |

<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": "Group ID"
      }
    },
    "required": [
      "PCID",
      "group_id"
    ]
  }
  ```
</Expandable>

***

## freshservice\_people\_delete\_department

Delete a Department

**Parameters:**

| Parameter       | Type    | Required | Default | Description   |
| --------------- | ------- | -------- | ------- | ------------- |
| `department_id` | integer | Yes      | —       | Department ID |

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

***

## freshservice\_people\_delete\_location

Delete a Location

**Parameters:**

| Parameter     | Type    | Required | Default | Description |
| ------------- | ------- | -------- | ------- | ----------- |
| `location_id` | integer | Yes      | —       | Location ID |

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

***

## freshservice\_people\_delete\_requester\_group

Delete a Requester Group

**Parameters:**

| Parameter            | Type    | Required | Default | Description        |
| -------------------- | ------- | -------- | ------- | ------------------ |
| `requester_group_id` | integer | Yes      | —       | Requester Group ID |

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

***

## freshservice\_people\_get\_agent

View an Agent

**Parameters:**

| Parameter  | Type    | Required | Default | Description |
| ---------- | ------- | -------- | ------- | ----------- |
| `agent_id` | integer | Yes      | —       | Agent ID    |

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

***

## freshservice\_people\_get\_agent\_group

View an Agent Group

**Parameters:**

| Parameter  | Type    | Required | Default | Description |
| ---------- | ------- | -------- | ------- | ----------- |
| `group_id` | integer | Yes      | —       | Group ID    |

<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": "Group ID"
      }
    },
    "required": [
      "PCID",
      "group_id"
    ]
  }
  ```
</Expandable>

***

## freshservice\_people\_get\_department

View a Department

**Parameters:**

| Parameter       | Type    | Required | Default | Description   |
| --------------- | ------- | -------- | ------- | ------------- |
| `department_id` | integer | Yes      | —       | Department ID |

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

***

## freshservice\_people\_get\_location

View a Location

**Parameters:**

| Parameter     | Type    | Required | Default | Description |
| ------------- | ------- | -------- | ------- | ----------- |
| `location_id` | integer | Yes      | —       | Location ID |

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

***

## freshservice\_people\_get\_requester

View a Requester

**Parameters:**

| Parameter      | Type    | Required | Default | Description  |
| -------------- | ------- | -------- | ------- | ------------ |
| `requester_id` | integer | Yes      | —       | Requester ID |

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

***

## freshservice\_people\_get\_requester\_group

View a Requester Group

**Parameters:**

| Parameter            | Type    | Required | Default | Description        |
| -------------------- | ------- | -------- | ------- | ------------------ |
| `requester_group_id` | integer | Yes      | —       | Requester Group ID |

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

***

## freshservice\_people\_get\_role

View a Role

**Parameters:**

| Parameter | Type    | Required | Default | Description |
| --------- | ------- | -------- | ------- | ----------- |
| `role_id` | integer | Yes      | —       | Role ID     |

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

***

## freshservice\_people\_list\_agent\_fields

List All Agent Fields

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

***

## freshservice\_people\_list\_agent\_groups

List All Agent Groups

**Parameters:**

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

***

## freshservice\_people\_list\_agents

List All Agents

**Parameters:**

| Parameter  | Type    | Required | Default | Description              |
| ---------- | ------- | -------- | ------- | ------------------------ |
| `page`     | integer | No       | —       | Page number              |
| `per_page` | integer | No       | —       | Items per page (max 100) |
| `email`    | string  | No       | —       | Filter by email          |
| `active`   | boolean | No       | —       | Filter: true/false       |
| `state`    | string  | No       | —       | Filter by state          |

<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"
      },
      "per_page": {
        "type": "integer",
        "description": "Items per page (max 100)"
      },
      "email": {
        "type": "string",
        "description": "Filter by email"
      },
      "active": {
        "type": "boolean",
        "description": "Filter: true/false"
      },
      "state": {
        "type": "string",
        "description": "Filter by state"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## freshservice\_people\_list\_department\_fields

List All Department Fields

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

***

## freshservice\_people\_list\_departments

List All Departments

**Parameters:**

| Parameter      | Type    | Required | Default | Description              |
| -------------- | ------- | -------- | ------- | ------------------------ |
| `page`         | integer | No       | —       | Page number              |
| `per_page`     | integer | No       | —       | Items per page (max 100) |
| `workspace_id` | integer | No       | —       | Workspace                |

<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"
      },
      "per_page": {
        "type": "integer",
        "description": "Items per page (max 100)"
      },
      "workspace_id": {
        "type": "integer",
        "description": "Workspace"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## freshservice\_people\_list\_locations

List All Locations

**Parameters:**

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

***

## freshservice\_people\_list\_requester\_fields

List All Requester Fields

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

***

## freshservice\_people\_list\_requester\_group\_members

List Requester Group Members

**Parameters:**

| Parameter            | Type    | Required | Default | Description              |
| -------------------- | ------- | -------- | ------- | ------------------------ |
| `requester_group_id` | integer | Yes      | —       | Requester Group ID       |
| `page`               | integer | No       | —       | Page number              |
| `per_page`           | integer | No       | —       | Items per page (max 100) |

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

***

## freshservice\_people\_list\_requester\_groups

List All Requester Groups

**Parameters:**

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

***

## freshservice\_people\_list\_requesters

List All Requesters

**Parameters:**

| Parameter             | Type    | Required | Default | Description              |
| --------------------- | ------- | -------- | ------- | ------------------------ |
| `page`                | integer | No       | —       | Page number              |
| `per_page`            | integer | No       | —       | Items per page (max 100) |
| `email`               | string  | No       | —       | Filter by email          |
| `mobile_phone_number` | string  | No       | —       | Filter by mobile         |
| `work_phone_number`   | string  | No       | —       | Filter by work phone     |

<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"
      },
      "per_page": {
        "type": "integer",
        "description": "Items per page (max 100)"
      },
      "email": {
        "type": "string",
        "description": "Filter by email"
      },
      "mobile_phone_number": {
        "type": "string",
        "description": "Filter by mobile"
      },
      "work_phone_number": {
        "type": "string",
        "description": "Filter by work phone"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## freshservice\_people\_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>

***

## freshservice\_people\_merge\_requesters

Merge Requesters

**Parameters:**

| Parameter                 | Type       | Required | Default | Description               |
| ------------------------- | ---------- | -------- | ------- | ------------------------- |
| `requester_id`            | integer    | Yes      | —       | Primary requester ID      |
| `secondary_requester_ids` | integer\[] | Yes      | —       | IDs to merge into primary |

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

***

## freshservice\_people\_reactivate\_agent

Reactivate an Agent

**Parameters:**

| Parameter  | Type    | Required | Default | Description |
| ---------- | ------- | -------- | ------- | ----------- |
| `agent_id` | integer | Yes      | —       | Agent ID    |

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

***

## freshservice\_people\_reactivate\_requester

Reactivate a Requester

**Parameters:**

| Parameter      | Type    | Required | Default | Description  |
| -------------- | ------- | -------- | ------- | ------------ |
| `requester_id` | integer | Yes      | —       | Requester ID |

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

***

## freshservice\_people\_remove\_requester\_group\_member

Remove Member from Requester Group

**Parameters:**

| Parameter            | Type    | Required | Default | Description  |
| -------------------- | ------- | -------- | ------- | ------------ |
| `requester_group_id` | integer | Yes      | —       | Group ID     |
| `requester_id`       | integer | Yes      | —       | Requester ID |

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

***

## freshservice\_people\_update\_agent

Update an Agent

**Parameters:**

| Parameter        | Type       | Required | Default | Description          |
| ---------------- | ---------- | -------- | ------- | -------------------- |
| `agent_id`       | integer    | Yes      | —       | Agent ID             |
| `custom_fields`  | object     | No       | —       | Custom fields        |
| `department_ids` | integer\[] | No       | —       | Department IDs       |
| `first_name`     | string     | No       | —       | First name           |
| `job_title`      | string     | No       | —       | Job title            |
| `last_name`      | string     | No       | —       | Last name            |
| `location_id`    | integer    | No       | —       | Location             |
| `occasional`     | boolean    | No       | —       | The occasional value |
| `roles`          | object\[]  | No       | —       | The roles value      |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "agent_id": {
        "type": "integer",
        "description": "Agent ID"
      },
      "custom_fields": {
        "type": "object",
        "description": "Custom fields"
      },
      "department_ids": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "Department IDs"
      },
      "first_name": {
        "type": "string",
        "description": "First name"
      },
      "job_title": {
        "type": "string",
        "description": "Job title"
      },
      "last_name": {
        "type": "string",
        "description": "Last name"
      },
      "location_id": {
        "type": "integer",
        "description": "Location"
      },
      "occasional": {
        "type": "boolean",
        "description": "The occasional value"
      },
      "roles": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "The roles value"
      }
    },
    "required": [
      "PCID",
      "agent_id"
    ]
  }
  ```
</Expandable>

***

## freshservice\_people\_update\_agent\_group

Update an Agent Group

**Parameters:**

| Parameter     | Type       | Required | Default | Description           |
| ------------- | ---------- | -------- | ------- | --------------------- |
| `group_id`    | integer    | Yes      | —       | Group ID              |
| `description` | string     | No       | —       | The description value |
| `leaders`     | integer\[] | No       | —       | The leaders value     |
| `members`     | integer\[] | No       | —       | The members value     |
| `name`        | string     | No       | —       | The name value        |
| `observers`   | integer\[] | No       | —       | The observers value   |

<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": "Group ID"
      },
      "description": {
        "type": "string",
        "description": "The description value"
      },
      "leaders": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "The leaders value"
      },
      "members": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "The members value"
      },
      "name": {
        "type": "string",
        "description": "The name value"
      },
      "observers": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "The observers value"
      }
    },
    "required": [
      "PCID",
      "group_id"
    ]
  }
  ```
</Expandable>

***

## freshservice\_people\_update\_department

Update a Department

**Parameters:**

| Parameter       | Type      | Required | Default | Description           |
| --------------- | --------- | -------- | ------- | --------------------- |
| `department_id` | integer   | Yes      | —       | Department ID         |
| `custom_fields` | object    | No       | —       | Custom fields         |
| `description`   | string    | No       | —       | The description value |
| `domains`       | string\[] | No       | —       | The domains value     |
| `head_user_id`  | integer   | No       | —       | Head user             |
| `name`          | string    | No       | —       | The name value        |
| `prime_user_id` | integer   | No       | —       | Prime user            |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "department_id": {
        "type": "integer",
        "description": "Department ID"
      },
      "custom_fields": {
        "type": "object",
        "description": "Custom fields"
      },
      "description": {
        "type": "string",
        "description": "The description value"
      },
      "domains": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "The domains value"
      },
      "head_user_id": {
        "type": "integer",
        "description": "Head user"
      },
      "name": {
        "type": "string",
        "description": "The name value"
      },
      "prime_user_id": {
        "type": "integer",
        "description": "Prime user"
      }
    },
    "required": [
      "PCID",
      "department_id"
    ]
  }
  ```
</Expandable>

***

## freshservice\_people\_update\_location

Update a Location

**Parameters:**

| Parameter     | Type    | Required | Default | Description       |
| ------------- | ------- | -------- | ------- | ----------------- |
| `location_id` | integer | Yes      | —       | Location ID       |
| `city`        | string  | No       | —       | The city value    |
| `country`     | string  | No       | —       | The country value |
| `line1`       | string  | No       | —       | Line 1            |
| `name`        | string  | No       | —       | The name value    |
| `state`       | string  | No       | —       | The state value   |
| `zipcode`     | string  | No       | —       | Zip               |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "location_id": {
        "type": "integer",
        "description": "Location ID"
      },
      "city": {
        "type": "string",
        "description": "The city value"
      },
      "country": {
        "type": "string",
        "description": "The country value"
      },
      "line1": {
        "type": "string",
        "description": "Line 1"
      },
      "name": {
        "type": "string",
        "description": "The name value"
      },
      "state": {
        "type": "string",
        "description": "The state value"
      },
      "zipcode": {
        "type": "string",
        "description": "Zip"
      }
    },
    "required": [
      "PCID",
      "location_id"
    ]
  }
  ```
</Expandable>

***

## freshservice\_people\_update\_requester

Update a Requester

**Parameters:**

| Parameter        | Type       | Required | Default | Description    |
| ---------------- | ---------- | -------- | ------- | -------------- |
| `requester_id`   | integer    | Yes      | —       | Requester ID   |
| `custom_fields`  | object     | No       | —       | Custom fields  |
| `department_ids` | integer\[] | No       | —       | Department IDs |
| `first_name`     | string     | No       | —       | First name     |
| `job_title`      | string     | No       | —       | Job title      |
| `last_name`      | string     | No       | —       | Last name      |
| `location_id`    | integer    | No       | —       | Location       |
| `primary_email`  | string     | No       | —       | Email          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "requester_id": {
        "type": "integer",
        "description": "Requester ID"
      },
      "custom_fields": {
        "type": "object",
        "description": "Custom fields"
      },
      "department_ids": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "Department IDs"
      },
      "first_name": {
        "type": "string",
        "description": "First name"
      },
      "job_title": {
        "type": "string",
        "description": "Job title"
      },
      "last_name": {
        "type": "string",
        "description": "Last name"
      },
      "location_id": {
        "type": "integer",
        "description": "Location"
      },
      "primary_email": {
        "type": "string",
        "description": "Email"
      }
    },
    "required": [
      "PCID",
      "requester_id"
    ]
  }
  ```
</Expandable>

***

## freshservice\_people\_update\_requester\_group

Update a Requester Group

**Parameters:**

| Parameter            | Type    | Required | Default | Description           |
| -------------------- | ------- | -------- | ------- | --------------------- |
| `requester_group_id` | integer | Yes      | —       | Requester Group ID    |
| `description`        | string  | No       | —       | The description value |
| `name`               | string  | No       | —       | The name value        |

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