/freshservice | Type: Application | PCID required: Yes
IT service management tickets, assets, and agents
Tools
| Tool | Description |
|---|---|
freshservice_list_tickets | List all tickets with optional filtering and pagination. Status values: 2=Open, 3=Pending, 4=Resolved, 5=Closed. Priority values: 1=Low, 2=Medium, 3=High, 4=Urgent. |
freshservice_get_ticket | Get detailed information about a specific ticket by ID |
freshservice_create_ticket | Create a new ticket. Status values: 2=Open, 3=Pending, 4=Resolved, 5=Closed. Priority values: 1=Low, 2=Medium, 3=High, 4=Urgent. Source values: 1=Email, 2=Portal, 3=Phone, 4=Chat. |
freshservice_update_ticket | Update an existing ticket with new priority, status, responder, or group assignment |
freshservice_list_assets | List all assets with optional pagination |
freshservice_create_asset | Create a new asset with specified details |
freshservice_list_requesters | List all requesters/users with optional pagination |
freshservice_create_requester | Create a new requester/user |
freshservice_list_agents | List all agents with optional pagination |
freshservice_create_agent | Create a new agent with specified details |
freshservice_list_departments | List all departments with optional pagination |
freshservice_create_department | Create a new department |
freshservice_delete_ticket | Delete a ticket by ID. The ticket will be moved to trash and can be restored later. |
freshservice_list_ticket_conversations | List all conversations (replies and notes) for a specific ticket. Returns the full conversation history including public replies, private notes, and system messages. |
freshservice_add_ticket_note | Add a note to a ticket. Notes can be private (visible only to agents) or public (visible to requester and agents). |
freshservice_reply_to_ticket | Send a reply to a ticket. The reply will be sent as an email to the requester and will appear in the ticket conversation thread. |
freshservice_get_asset | Get detailed information about a specific asset by its display ID |
freshservice_update_asset | Update an existing asset with new details |
freshservice_search_assets | Search assets using a query string. Query format follows Freshservice filter syntax, e.g. “asset_type_id:1” or “name:‘laptop’”. |
freshservice_list_agent_groups | List all agent groups with optional pagination. Agent groups are used for ticket assignment and routing. |
freshservice_list_locations | List all locations with optional pagination. Locations are used by assets, agents, and requesters. |
freshservice_list_changes | List all change requests with optional pagination. Status values: 1=Open, 2=Planning, 3=Awaiting Approval, 4=Pending Release, 5=Pending Review, 6=Closed. |
freshservice_create_change | Create a new change request. Status: 1=Open, 2=Planning, 3=Awaiting Approval, 4=Pending Release, 5=Pending Review, 6=Closed. Priority: 1=Low, 2=Medium, 3=High, 4=Urgent. Risk: 1=Low, 2=Medium, 3=High, 4=Very High. Impact: 1=Low, 2=Medium, 3=High. Change type: 1=Minor, 2=Standard, 3=Major, 4=Emergency. |
freshservice_list_problems | List all problems with optional pagination. Status values: 1=Open, 2=Change Requested, 3=Closed. |
freshservice_create_problem | Create a new problem record. Status: 1=Open, 2=Change Requested, 3=Closed. Priority: 1=Low, 2=Medium, 3=High, 4=Urgent. Impact: 1=Low, 2=Medium, 3=High. |
freshservice_list_service_catalog_items | List all service catalog items with optional pagination. Service catalog items are the services that requesters can browse and submit requests for. |
freshservice_list_tickets
List all tickets with optional filtering and pagination. Status values: 2=Open, 3=Pending, 4=Resolved, 5=Closed. Priority values: 1=Low, 2=Medium, 3=High, 4=Urgent. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filter | string | No | — | Filter criteria for tickets |
page | number | No | — | Page number for pagination |
per_page | number | No | — | Number of tickets per page |
freshservice_get_ticket
Get detailed information about a specific ticket by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ticket_id | number | Yes | — | Ticket ID to retrieve |
freshservice_create_ticket
Create a new ticket. Status values: 2=Open, 3=Pending, 4=Resolved, 5=Closed. Priority values: 1=Low, 2=Medium, 3=High, 4=Urgent. Source values: 1=Email, 2=Portal, 3=Phone, 4=Chat. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
subject | string | Yes | — | Ticket subject |
description | string | Yes | — | Ticket description |
email | string | No | — | Requester email |
priority | number | No | — | Priority: 1=Low, 2=Medium, 3=High, 4=Urgent |
status | number | No | — | Status: 2=Open, 3=Pending, 4=Resolved, 5=Closed |
source | number | No | — | Source: 1=Email, 2=Portal, 3=Phone, 4=Chat |
type | string | No | — | Ticket type (e.g., “Service Request”, “Incident”) |
category | string | No | — | Ticket category |
sub_category | string | No | — | Ticket sub-category |
item_category | string | No | — | Ticket item category |
freshservice_update_ticket
Update an existing ticket with new priority, status, responder, or group assignment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ticket_id | number | Yes | — | Ticket ID to update |
priority | number | No | — | New priority: 1=Low, 2=Medium, 3=High, 4=Urgent |
status | number | No | — | New status: 2=Open, 3=Pending, 4=Resolved, 5=Closed |
responder_id | number | No | — | ID of the responder to assign |
group_id | number | No | — | ID of the group to assign |
freshservice_list_assets
List all assets with optional pagination Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | number | No | — | Page number for pagination |
per_page | number | No | — | Number of assets per page |
freshservice_create_asset
Create a new asset with specified details Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | Yes | — | Asset name |
description | string | No | — | Asset description |
asset_type_id | number | No | — | Asset type ID |
asset_tag | string | No | — | Asset tag |
serial_number | string | No | — | Asset serial number |
status | number | No | — | Asset status |
user_id | number | No | — | User ID assigned to asset |
location_id | number | No | — | Location ID |
department_id | number | No | — | Department ID |
freshservice_list_requesters
List all requesters/users with optional pagination Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | number | No | — | Page number for pagination |
per_page | number | No | — | Number of requesters per page |
freshservice_create_requester
Create a new requester/user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
first_name | string | Yes | — | First name |
last_name | string | Yes | — | Last name |
email | string | Yes | — | Email address |
phone | string | No | — | Phone number |
mobile | string | No | — | Mobile number |
department_id | number | No | — | Department ID |
location_id | number | No | — | Location ID |
active | boolean | No | — | Whether the user is active |
freshservice_list_agents
List all agents with optional pagination Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | number | No | — | Page number for pagination |
per_page | number | No | — | Number of agents per page |
freshservice_create_agent
Create a new agent with specified details Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
first_name | string | Yes | — | First name |
last_name | string | Yes | — | Last name |
email | string | Yes | — | Email address |
phone | string | No | — | Phone number |
mobile | string | No | — | Mobile number |
job_title | string | No | — | Job title |
active | boolean | No | — | Whether the agent is active |
department_id | number | No | — | Department ID |
location_id | number | No | — | Location ID |
role_id | number | No | — | Role ID |
group_ids | number[] | No | — | Array of group IDs |
freshservice_list_departments
List all departments with optional pagination Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | number | No | — | Page number for pagination |
per_page | number | No | — | Number of departments per page |
freshservice_create_department
Create a new department Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | Yes | — | Department name |
description | string | No | — | Department description |
head_user_id | number | No | — | Head user ID |
prime_user_id | number | No | — | Prime user ID |
domains | string[] | No | — | Array of domain names |
freshservice_delete_ticket
Delete a ticket by ID. The ticket will be moved to trash and can be restored later. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ticket_id | number | Yes | — | Ticket ID to delete |
freshservice_list_ticket_conversations
List all conversations (replies and notes) for a specific ticket. Returns the full conversation history including public replies, private notes, and system messages. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ticket_id | number | Yes | — | Ticket ID to get conversations for |
freshservice_add_ticket_note
Add a note to a ticket. Notes can be private (visible only to agents) or public (visible to requester and agents). Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ticket_id | number | Yes | — | Ticket ID to add the note to |
body | string | Yes | — | HTML content of the note |
private | boolean | No | — | Whether this is a private note (default: true). Private notes are only visible to agents. |
freshservice_reply_to_ticket
Send a reply to a ticket. The reply will be sent as an email to the requester and will appear in the ticket conversation thread. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ticket_id | number | Yes | — | Ticket ID to reply to |
body | string | Yes | — | HTML content of the reply |
cc_emails | string[] | No | — | Array of CC email addresses |
bcc_emails | string[] | No | — | Array of BCC email addresses |
freshservice_get_asset
Get detailed information about a specific asset by its display ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
asset_display_id | number | Yes | — | Asset display ID to retrieve |
freshservice_update_asset
Update an existing asset with new details Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
asset_display_id | number | Yes | — | Asset display ID to update |
name | string | No | — | New asset name |
description | string | No | — | New asset description |
asset_type_id | number | No | — | New asset type ID |
asset_tag | string | No | — | New asset tag |
status | number | No | — | New asset status |
user_id | number | No | — | New user ID assigned to asset |
location_id | number | No | — | New location ID |
department_id | number | No | — | New department ID |
freshservice_search_assets
Search assets using a query string. Query format follows Freshservice filter syntax, e.g. “asset_type_id:1” or “name:‘laptop’”. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | — | Search query string using Freshservice filter syntax (e.g. “asset_type_id:1”, “name:‘laptop’“) |
freshservice_list_agent_groups
List all agent groups with optional pagination. Agent groups are used for ticket assignment and routing. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | number | No | — | Page number for pagination |
per_page | number | No | — | Number of groups per page |
freshservice_list_locations
List all locations with optional pagination. Locations are used by assets, agents, and requesters. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | number | No | — | Page number for pagination |
per_page | number | No | — | Number of locations per page |
freshservice_list_changes
List all change requests with optional pagination. Status values: 1=Open, 2=Planning, 3=Awaiting Approval, 4=Pending Release, 5=Pending Review, 6=Closed. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | number | No | — | Page number for pagination |
per_page | number | No | — | Number of changes per page |
freshservice_create_change
Create a new change request. Status: 1=Open, 2=Planning, 3=Awaiting Approval, 4=Pending Release, 5=Pending Review, 6=Closed. Priority: 1=Low, 2=Medium, 3=High, 4=Urgent. Risk: 1=Low, 2=Medium, 3=High, 4=Very High. Impact: 1=Low, 2=Medium, 3=High. Change type: 1=Minor, 2=Standard, 3=Major, 4=Emergency. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
subject | string | Yes | — | Change request subject |
description | string | No | — | Change request description (HTML) |
agent_id | number | No | — | ID of the agent assigned |
requester_id | number | No | — | ID of the requester |
priority | number | No | — | Priority: 1=Low, 2=Medium, 3=High, 4=Urgent |
status | number | No | — | Status: 1=Open, 2=Planning, 3=Awaiting Approval, 4=Pending Release, 5=Pending Review, 6=Closed |
risk | number | No | — | Risk: 1=Low, 2=Medium, 3=High, 4=Very High |
impact | number | No | — | Impact: 1=Low, 2=Medium, 3=High |
change_type | number | No | — | Change type: 1=Minor, 2=Standard, 3=Major, 4=Emergency |
planned_start_date | string | No | — | Planned start date (ISO 8601 format) |
planned_end_date | string | No | — | Planned end date (ISO 8601 format) |
freshservice_list_problems
List all problems with optional pagination. Status values: 1=Open, 2=Change Requested, 3=Closed. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | number | No | — | Page number for pagination |
per_page | number | No | — | Number of problems per page |
freshservice_create_problem
Create a new problem record. Status: 1=Open, 2=Change Requested, 3=Closed. Priority: 1=Low, 2=Medium, 3=High, 4=Urgent. Impact: 1=Low, 2=Medium, 3=High. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
subject | string | Yes | — | Problem subject |
description | string | No | — | Problem description (HTML) |
agent_id | number | No | — | ID of the agent assigned |
requester_id | number | No | — | ID of the requester |
priority | number | No | — | Priority: 1=Low, 2=Medium, 3=High, 4=Urgent |
status | number | No | — | Status: 1=Open, 2=Change Requested, 3=Closed |
impact | number | No | — | Impact: 1=Low, 2=Medium, 3=High |
due_by | string | No | — | Due date (ISO 8601 format) |
freshservice_list_service_catalog_items
List all service catalog items with optional pagination. Service catalog items are the services that requesters can browse and submit requests for. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | number | No | — | Page number for pagination |
per_page | number | No | — | Number of items per page |

