Skip to main content
Server path: /freshservice | Type: Application | PCID required: Yes IT service management tickets, assets, and agents

Tools

ToolDescription
freshservice_list_ticketsList 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_ticketGet detailed information about a specific ticket by ID
freshservice_create_ticketCreate 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_ticketUpdate an existing ticket with new priority, status, responder, or group assignment
freshservice_list_assetsList all assets with optional pagination
freshservice_create_assetCreate a new asset with specified details
freshservice_list_requestersList all requesters/users with optional pagination
freshservice_create_requesterCreate a new requester/user
freshservice_list_agentsList all agents with optional pagination
freshservice_create_agentCreate a new agent with specified details
freshservice_list_departmentsList all departments with optional pagination
freshservice_create_departmentCreate a new department
freshservice_delete_ticketDelete a ticket by ID. The ticket will be moved to trash and can be restored later.
freshservice_list_ticket_conversationsList 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_noteAdd a note to a ticket. Notes can be private (visible only to agents) or public (visible to requester and agents).
freshservice_reply_to_ticketSend 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_assetGet detailed information about a specific asset by its display ID
freshservice_update_assetUpdate an existing asset with new details
freshservice_search_assetsSearch assets using a query string. Query format follows Freshservice filter syntax, e.g. “asset_type_id:1” or “name:‘laptop’”.
freshservice_list_agent_groupsList all agent groups with optional pagination. Agent groups are used for ticket assignment and routing.
freshservice_list_locationsList all locations with optional pagination. Locations are used by assets, agents, and requesters.
freshservice_list_changesList 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_changeCreate 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_problemsList all problems with optional pagination. Status values: 1=Open, 2=Change Requested, 3=Closed.
freshservice_create_problemCreate 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_itemsList 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:
ParameterTypeRequiredDefaultDescription
filterstringNoFilter criteria for tickets
pagenumberNoPage number for pagination
per_pagenumberNoNumber of tickets per page

freshservice_get_ticket

Get detailed information about a specific ticket by ID Parameters:
ParameterTypeRequiredDefaultDescription
ticket_idnumberYesTicket 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:
ParameterTypeRequiredDefaultDescription
subjectstringYesTicket subject
descriptionstringYesTicket description
emailstringNoRequester email
prioritynumberNoPriority: 1=Low, 2=Medium, 3=High, 4=Urgent
statusnumberNoStatus: 2=Open, 3=Pending, 4=Resolved, 5=Closed
sourcenumberNoSource: 1=Email, 2=Portal, 3=Phone, 4=Chat
typestringNoTicket type (e.g., “Service Request”, “Incident”)
categorystringNoTicket category
sub_categorystringNoTicket sub-category
item_categorystringNoTicket item category

freshservice_update_ticket

Update an existing ticket with new priority, status, responder, or group assignment Parameters:
ParameterTypeRequiredDefaultDescription
ticket_idnumberYesTicket ID to update
prioritynumberNoNew priority: 1=Low, 2=Medium, 3=High, 4=Urgent
statusnumberNoNew status: 2=Open, 3=Pending, 4=Resolved, 5=Closed
responder_idnumberNoID of the responder to assign
group_idnumberNoID of the group to assign

freshservice_list_assets

List all assets with optional pagination Parameters:
ParameterTypeRequiredDefaultDescription
pagenumberNoPage number for pagination
per_pagenumberNoNumber of assets per page

freshservice_create_asset

Create a new asset with specified details Parameters:
ParameterTypeRequiredDefaultDescription
namestringYesAsset name
descriptionstringNoAsset description
asset_type_idnumberNoAsset type ID
asset_tagstringNoAsset tag
serial_numberstringNoAsset serial number
statusnumberNoAsset status
user_idnumberNoUser ID assigned to asset
location_idnumberNoLocation ID
department_idnumberNoDepartment ID

freshservice_list_requesters

List all requesters/users with optional pagination Parameters:
ParameterTypeRequiredDefaultDescription
pagenumberNoPage number for pagination
per_pagenumberNoNumber of requesters per page

freshservice_create_requester

Create a new requester/user Parameters:
ParameterTypeRequiredDefaultDescription
first_namestringYesFirst name
last_namestringYesLast name
emailstringYesEmail address
phonestringNoPhone number
mobilestringNoMobile number
department_idnumberNoDepartment ID
location_idnumberNoLocation ID
activebooleanNoWhether the user is active

freshservice_list_agents

List all agents with optional pagination Parameters:
ParameterTypeRequiredDefaultDescription
pagenumberNoPage number for pagination
per_pagenumberNoNumber of agents per page

freshservice_create_agent

Create a new agent with specified details Parameters:
ParameterTypeRequiredDefaultDescription
first_namestringYesFirst name
last_namestringYesLast name
emailstringYesEmail address
phonestringNoPhone number
mobilestringNoMobile number
job_titlestringNoJob title
activebooleanNoWhether the agent is active
department_idnumberNoDepartment ID
location_idnumberNoLocation ID
role_idnumberNoRole ID
group_idsnumber[]NoArray of group IDs

freshservice_list_departments

List all departments with optional pagination Parameters:
ParameterTypeRequiredDefaultDescription
pagenumberNoPage number for pagination
per_pagenumberNoNumber of departments per page

freshservice_create_department

Create a new department Parameters:
ParameterTypeRequiredDefaultDescription
namestringYesDepartment name
descriptionstringNoDepartment description
head_user_idnumberNoHead user ID
prime_user_idnumberNoPrime user ID
domainsstring[]NoArray of domain names

freshservice_delete_ticket

Delete a ticket by ID. The ticket will be moved to trash and can be restored later. Parameters:
ParameterTypeRequiredDefaultDescription
ticket_idnumberYesTicket 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:
ParameterTypeRequiredDefaultDescription
ticket_idnumberYesTicket 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:
ParameterTypeRequiredDefaultDescription
ticket_idnumberYesTicket ID to add the note to
bodystringYesHTML content of the note
privatebooleanNoWhether 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:
ParameterTypeRequiredDefaultDescription
ticket_idnumberYesTicket ID to reply to
bodystringYesHTML content of the reply
cc_emailsstring[]NoArray of CC email addresses
bcc_emailsstring[]NoArray of BCC email addresses

freshservice_get_asset

Get detailed information about a specific asset by its display ID Parameters:
ParameterTypeRequiredDefaultDescription
asset_display_idnumberYesAsset display ID to retrieve

freshservice_update_asset

Update an existing asset with new details Parameters:
ParameterTypeRequiredDefaultDescription
asset_display_idnumberYesAsset display ID to update
namestringNoNew asset name
descriptionstringNoNew asset description
asset_type_idnumberNoNew asset type ID
asset_tagstringNoNew asset tag
statusnumberNoNew asset status
user_idnumberNoNew user ID assigned to asset
location_idnumberNoNew location ID
department_idnumberNoNew 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:
ParameterTypeRequiredDefaultDescription
querystringYesSearch 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:
ParameterTypeRequiredDefaultDescription
pagenumberNoPage number for pagination
per_pagenumberNoNumber of groups per page

freshservice_list_locations

List all locations with optional pagination. Locations are used by assets, agents, and requesters. Parameters:
ParameterTypeRequiredDefaultDescription
pagenumberNoPage number for pagination
per_pagenumberNoNumber 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:
ParameterTypeRequiredDefaultDescription
pagenumberNoPage number for pagination
per_pagenumberNoNumber 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:
ParameterTypeRequiredDefaultDescription
subjectstringYesChange request subject
descriptionstringNoChange request description (HTML)
agent_idnumberNoID of the agent assigned
requester_idnumberNoID of the requester
prioritynumberNoPriority: 1=Low, 2=Medium, 3=High, 4=Urgent
statusnumberNoStatus: 1=Open, 2=Planning, 3=Awaiting Approval, 4=Pending Release, 5=Pending Review, 6=Closed
risknumberNoRisk: 1=Low, 2=Medium, 3=High, 4=Very High
impactnumberNoImpact: 1=Low, 2=Medium, 3=High
change_typenumberNoChange type: 1=Minor, 2=Standard, 3=Major, 4=Emergency
planned_start_datestringNoPlanned start date (ISO 8601 format)
planned_end_datestringNoPlanned end date (ISO 8601 format)

freshservice_list_problems

List all problems with optional pagination. Status values: 1=Open, 2=Change Requested, 3=Closed. Parameters:
ParameterTypeRequiredDefaultDescription
pagenumberNoPage number for pagination
per_pagenumberNoNumber 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:
ParameterTypeRequiredDefaultDescription
subjectstringYesProblem subject
descriptionstringNoProblem description (HTML)
agent_idnumberNoID of the agent assigned
requester_idnumberNoID of the requester
prioritynumberNoPriority: 1=Low, 2=Medium, 3=High, 4=Urgent
statusnumberNoStatus: 1=Open, 2=Change Requested, 3=Closed
impactnumberNoImpact: 1=Low, 2=Medium, 3=High
due_bystringNoDue 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:
ParameterTypeRequiredDefaultDescription
pagenumberNoPage number for pagination
per_pagenumberNoNumber of items per page