The Freshservice connector lets your AI agent act in each user's Freshservice account. Each user connects their own Freshservice API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 119 tools.
- Tools
- 119
- What they doRead · write · destructive
- 83 · 36 · 083 read36 write0 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Freshservice connection
In AgentKit > Connections, create a Freshservice connection. The name you give it is the
connection_nameyour code passes. See Configure connections.
Tools
Pass the exact name toexecute_toolfreshservice_agent_fields_listList the fields on Freshservice agent profiles, including custom fields.Read-onlyList Agent Fields
List the fields on Freshservice agent profiles, including custom fields. Returns each field's name, label, type, required flags and choices. Use this to learn field names before filtering agents.
Inputs
This tool takes no inputs.
freshservice_agent_getGet one Freshservice agent by user ID.Read-onlyGet Agent
Get one Freshservice agent by user ID. Returns the agent object with name, email, phones, occasional flag, departments, location and roles. Use this when you know the agent ID. Use freshservice_agents_list or freshservice_agents_filter to find it.
Inputs
agent_idintegerrequired- Numeric ID of the agent (user ID).
freshservice_agent_group_getGet one Freshservice agent group by ID.Read-onlyGet Agent Group
Get one Freshservice agent group by ID. Returns the group with name, description, members, observers, leaders, business hours and escalation settings. Use this to see who is in a support team.
Inputs
group_idintegerrequired- Numeric ID of the agent group.
freshservice_agent_groups_listList Freshservice agent groups (support teams).Read-onlyList Agent Groups
List Freshservice agent groups (support teams). Returns group objects with id, name, description, members, observers, leaders and escalation settings. Use this to find group IDs for assigning tickets, problems, changes and tasks. Use freshservice_agent_group_get for one group.
Inputs
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
workspace_idinteger- ID of the workspace to list agent groups from. Omit to use the primary workspace; pass 0 to return agent groups from every workspace you can access (global fields only). Applies only to accounts that use workspaces.
freshservice_agents_filterFilter Freshservice agents with a query on agent fields, including starts-with searches.Read-onlyFilter Agents
Filter Freshservice agents with a query on agent fields, including starts-with searches. Returns matching agent objects under an agents array, newest first, 30 per page (page 40 at most). Use this to search agents by name, title, department, location or dates. Use freshservice_agents_list for an exact email or phone lookup.
Inputs
querystringrequired- Filter expression for agents, written without the surrounding double quotes (the tool adds them). Combine conditions as field:value with AND / OR and parentheses; put string and date values in single quotes and numbers bare; use :> and :< for greater-or-equal and less-or-equal. Supported fields: first_name, last_name, name, job_title, email, work_phone_number, mobile_phone_number, department_id, reporting_manager_id, time_zone, language, location_id, created_at, updated_at. Use ~[field1|field2]:'text' for starts-with search and null for empty fields. Example: name:'Lara Croft'
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
freshservice_agents_listList Freshservice agents sorted by first name, optionally matching an exact email or phone, active state or agent type.Read-onlyList Agents
List Freshservice agents sorted by first name, optionally matching an exact email or phone, active state or agent type. Returns a page of agent objects (30 by default) under an agents array. Use this to browse agents or find assignee IDs. Use freshservice_agents_filter for other fields or starts-with searches.
Inputs
activeboolean- true returns only active agents; false returns only deactivated agents.
emailstring- Return only the agent with this exact email address.
mobile_phone_numberstring- Return only agents with this exact mobile phone number.
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
statestring- Agent type: fulltime or occasional.one of
fulltimeoccasional work_phone_numberstring- Return only agents with this exact work phone number.
freshservice_announcement_getGet one Freshservice announcement by ID.Read-onlyGet Announcement
Get one Freshservice announcement by ID. Returns the announcement with title, HTML body, state, visibility, audience and active dates. Use this to read the full text of an announcement.
Inputs
announcement_idintegerrequired- Numeric ID of the announcement.
freshservice_announcements_listList announcements (service updates and outage notices) in Freshservice.Read-onlyList Announcements
List announcements (service updates and outage notices) in Freshservice. Returns announcement objects with title, body, state, visibility and active dates. Use this to check current notices before answering users.
Inputs
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
statestring- Return only announcements in this state: active, archived, scheduled or unread.one of
activearchivedscheduledunread workspace_idinteger- ID of the workspace to list announcements from. Omit to use the primary workspace; pass 0 to return announcements from every workspace you can access (global fields only). Applies only to accounts that use workspaces.
freshservice_approvals_listList Freshservice approval requests for tickets or changes, filtered by approver, status, parent record or delegatee.Read-onlyList Approvals
List Freshservice approval requests for tickets or changes, filtered by approver, status, parent record or delegatee. Returns up to 30 approval objects per page, oldest first. Use this to find approvals waiting on a person or attached to a record. Provide parent plus at least one of approver_id, status, parent_id or delegatee_id.
Inputs
parentstringrequired- Module the approvals belong to: ticket or change.one of
ticketchange approver_idinteger- Return approvals assigned to this approver user ID.
delegatee_idinteger- Return approvals delegated to this user ID.
levelinteger- Return approvals at this approval level.
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
parent_idinteger- Return approvals for this ticket or change ID.
statusstring- Return approvals in this status, for example requested, approved, rejected or cancelled.
freshservice_asset_components_listList the hardware components (processor, memory, disks and so on) of a Freshservice asset.Read-onlyList Asset Components
List the hardware components (processor, memory, disks and so on) of a Freshservice asset. Returns component objects with component_type and component_data details. Use this to see what an asset is made of.
Inputs
display_idintegerrequired- Numeric ID of the asset (its display ID).
freshservice_asset_contracts_listList the contracts (lease, maintenance, warranty and so on) an asset is associated with in Freshservice.Read-onlyList Asset Contracts
List the contracts (lease, maintenance, warranty and so on) an asset is associated with in Freshservice. Returns contract objects with contract number, type, name and status. Use this to check an asset's coverage. Use freshservice_contracts_list for all contracts.
Inputs
display_idintegerrequired- Numeric ID of the asset (its display ID).
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_asset_getGet one Freshservice asset by display ID.Read-onlyGet Asset
Get one Freshservice asset by display ID. Returns the asset object; set include=type_fields to add type-specific fields such as serial number, product and vendor. Use this when you know the display ID. This is the classic Assets API, for Freshservice accounts created before 31 March 2026; newer accounts use the ITAM tools (freshservice_itam_assets_list).
Inputs
display_idintegerrequired- Numeric ID of the asset (its display ID, not the internal id).
includestring- Set to type_fields to embed the asset-type-specific fields. Costs an extra API credit.one of
type_fields
freshservice_asset_requests_listList the tickets, problems, changes and other requests associated with a Freshservice asset.Read-onlyList Asset Requests
List the tickets, problems, changes and other requests associated with a Freshservice asset. Returns request objects with type, display ID (for example #INC-1), subject and status. Use this to see an asset's service history.
Inputs
display_idintegerrequired- Numeric ID of the asset (its display ID).
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_asset_type_fields_listList the fields of a Freshservice asset type, grouped into sections.Read-onlyList Asset Type Fields
List the fields of a Freshservice asset type, grouped into sections. Returns field definitions with name, label, type and choices, including inherited fields. Use this to learn the type_fields keys to send when creating or updating assets.
Inputs
asset_type_idintegerrequired- Numeric ID of the asset type.
freshservice_asset_type_getGet one Freshservice asset type by ID.Read-onlyGet Asset Type
Get one Freshservice asset type by ID. Returns the asset type with name, parent type and description. Use this to check an asset type. Use freshservice_asset_type_fields_list for its fields.
Inputs
asset_type_idintegerrequired- Numeric ID of the asset type.
freshservice_asset_types_listList the asset types (for example Hardware, Laptop, Software) defined in Freshservice.Read-onlyList Asset Types
List the asset types (for example Hardware, Laptop, Software) defined in Freshservice. Returns asset type objects with id, name, parent type, description and visibility. Use this to find asset_type_id for creating or filtering assets.
Inputs
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_assets_filterFilter Freshservice assets with a query on asset fields such as state, type, department, location or dates.Read-onlyFilter Assets
Filter Freshservice assets with a query on asset fields such as state, type, department, location or dates. Returns matching asset objects under an assets array, newest first, 30 per page. Use this for condition-based asset lists. Use freshservice_assets_search for a single identifier. This is the classic Assets API, for Freshservice accounts created before 31 March 2026; newer accounts use the ITAM tools (freshservice_itam_assets_list).
Inputs
filterstringrequired- Filter expression without the surrounding double quotes (the tool adds them). Combine field:value conditions with AND / OR; strings and dates in single quotes, numbers bare, :> and :< for ranges. Fields: workspace_id, asset_type_id, department_id, location_id, asset_state, user_id, agent_id, name, asset_tag, created_at, updated_at, serial_number, mac_addresses, ip_addresses, uuid, item_id, imei_number, device42_id. Example: asset_state:'IN STOCK' AND created_at:>'2026-01-01'
includestring- Set to type_fields to embed asset-type-specific fields. Costs extra API credits.one of
type_fields pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
freshservice_assets_listList Freshservice assets, newest first by default.Read-onlyList Assets
List Freshservice assets, newest first by default. Returns a page of asset objects (30 by default) under an assets array. Use this to browse assets. Use freshservice_assets_search to match identifiers such as name or serial number, and freshservice_assets_filter for field conditions. This is the classic Assets API, for Freshservice accounts created before 31 March 2026; newer accounts use the ITAM tools (freshservice_itam_assets_list).
Inputs
includestring- Set to type_fields to embed asset-type-specific fields for each asset. Costs extra API credits.one of
type_fields order_bystring- Field to sort by: id, created_at or updated_at. Defaults to created_at.one of
idcreated_atupdated_at order_typestring- Sort order: asc or desc. Defaults to desc.one of
ascdesc pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
trashedboolean- Set true to list assets in the trash instead of active ones.
workspace_idinteger- ID of the workspace to list assets from. Omit to use the primary workspace; pass 0 to return assets from every workspace you can access (global fields only). Applies only to accounts that use workspaces.
freshservice_assets_searchSearch Freshservice assets by an identifier such as name, asset tag, serial number, IP or MAC address.Read-onlySearch Assets
Search Freshservice assets by an identifier such as name, asset tag, serial number, IP or MAC address. Returns matching asset objects under an assets array, 30 per page; the total count is in the response headers. Use this to find an asset from one identifying value. Use freshservice_assets_filter to combine conditions such as state, type or location. This is the classic Assets API, for Freshservice accounts created before 31 March 2026; newer accounts use the ITAM tools (freshservice_itam_assets_list).
Inputs
searchstringrequired- Search expression without the surrounding double quotes (the tool adds them): field:'value'. Searchable fields: name, asset_tag, serial_number, mac_addresses, ip_addresses, uuid, item_id, imei_number. Escape apostrophes inside values with a backslash. Example: name:'dell'
includestring- Set to type_fields to embed asset-type-specific fields. Costs extra API credits.one of
type_fields pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
trashedboolean- Set true to search assets in the trash.
freshservice_business_hours_listList business hours configurations in Freshservice.Read-onlyList Business Hours
List business hours configurations in Freshservice. Returns configurations with name, time zone, working days and hours, and holidays. Use this to understand SLA clocks or the business_hours_id for agent groups.
Inputs
workspace_idinteger- Workspace ID to list business hours from. Omit for the primary workspace; 1 returns global business hours.
freshservice_canned_response_getGet one Freshservice canned response by ID.Read-onlyGet Canned Response
Get one Freshservice canned response by ID. Returns the response title, folder and HTML content. Use this to fetch template text to reuse in a ticket reply.
Inputs
canned_response_idintegerrequired- Numeric ID of the canned response.
freshservice_canned_responses_listList canned responses (reusable reply templates) in Freshservice.Read-onlyList Canned Responses
List canned responses (reusable reply templates) in Freshservice. Returns canned response objects with id, title, folder and HTML content. Use this to find a template before replying with freshservice_ticket_reply_create.
Inputs
workspace_idinteger- Workspace ID to list responses from. Omit for the primary workspace; 1 returns global canned responses.
freshservice_change_approvals_listList the approval requests on a Freshservice change.Read-onlyList Change Approvals
List the approval requests on a Freshservice change. Returns approval objects with approver, status, level and timestamps. Use this to check whether a change is approved (for example by the CAB). Use freshservice_approvals_list to search approvals across records.
Inputs
change_idintegerrequired- Numeric ID of the change.
freshservice_change_fields_listList the fields on the Freshservice change form, including custom fields.Read-onlyList Change Fields
List the fields on the Freshservice change form, including custom fields. Returns each field's name, label, type, required flags and allowed choices. Use this to learn valid field names before creating, updating or querying changes.
Inputs
workspace_idinteger- ID of the workspace to list change fields from. Omit to use the primary workspace; pass 0 to return change fields from every workspace you can access (global fields only). Applies only to accounts that use workspaces.
freshservice_change_getGet one Freshservice change by ID.Read-onlyGet Change
Get one Freshservice change by ID. Returns the change object with subject, status, risk, type, planned dates, approval status and custom fields. Use this when you know the change ID. Use freshservice_changes_list to browse or query.
Inputs
change_idintegerrequired- Numeric ID of the change.
freshservice_change_notes_listList the notes on a Freshservice change.Read-onlyList Change Notes
List the notes on a Freshservice change. Returns note objects with body, author and timestamps. Use this to read the change's discussion history.
Inputs
change_idintegerrequired- Numeric ID of the change.
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_change_tasks_listList the tasks on a Freshservice change.Read-onlyList Change Tasks
List the tasks on a Freshservice change. Returns task objects with title, status, assignee and due date. Use this to see the work items on a change.
Inputs
change_idintegerrequired- Numeric ID of the change.
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_changes_listList Freshservice changes, optionally narrowed by a saved view, a field query or an update date.Read-onlyList Changes
List Freshservice changes, optionally narrowed by a saved view, a field query or an update date. Returns a page of change objects (30 by default) under a changes array. Use this to browse or search changes. view and query cannot be used together.
Inputs
order_bystring- Field to sort by, for example created_at or priority.
order_typestring- Sort order: asc or desc. Defaults to desc.one of
ascdesc pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
querystring- Field filter, including the surrounding double quotes. Combine field:value conditions with AND / OR; strings and dates in single quotes, numbers bare. Do not combine with view. Example: "priority:4 OR priority:3"
updated_sincestring- Return changes updated at or after this ISO 8601 datetime.
viewstring- Name of a default view (for example my_open or unassigned) or the ID of a custom view in the Change module. Do not combine with query.
workspace_idinteger- ID of the workspace to list changes from. Omit to use the primary workspace; pass 0 to return changes from every workspace you can access (global fields only). Applies only to accounts that use workspaces.
freshservice_contracts_listList contracts (lease, maintenance, software licence, warranty) in Freshservice.Read-onlyList Contracts
List contracts (lease, maintenance, software licence, warranty) in Freshservice. Returns contract objects with number, name, type, vendor, cost, status and start and end dates. Use this to review contracts and renewals. Use freshservice_asset_contracts_list for one asset's contracts.
Inputs
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
workspace_idinteger- ID of the workspace to list contracts from. Omit to use the primary workspace; pass 0 to return contracts from every workspace you can access (global fields only). Applies only to accounts that use workspaces.
freshservice_department_getGet one Freshservice department by ID.Read-onlyGet Department
Get one Freshservice department by ID. Returns the department with name, description, head, prime user, domains and custom fields. Use this when you know the department ID.
Inputs
department_idintegerrequired- Numeric ID of the department.
freshservice_departments_listList Freshservice departments (called companies in MSP mode).Read-onlyList Departments
List Freshservice departments (called companies in MSP mode). Returns department objects with id, name, description, head, prime user, domains and custom fields. Use this to find department IDs for tickets, requesters and assets.
Inputs
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
workspace_idinteger- Workspace (client) ID to list departments from. Omit for workspace 2; values must be greater than 1.
freshservice_itam_asset_getGet one asset from Freshservice IT Asset Management (accounts created after 31 March 2026).Read-onlyGet ITAM Asset
Get one asset from Freshservice IT Asset Management (accounts created after 31 March 2026). Returns the asset record with identification, state, ownership, hardware and placement details. Use this on newer accounts. On older accounts use freshservice_asset_get.
Inputs
asset_idintegerrequired- Numeric ID of the ITAM asset record.
include_colsstring- Comma-separated properties to return, to trim the response. Examples: name, device_id, serial_no, asset_no, rack.
freshservice_itam_assets_listList assets in Freshservice IT Asset Management (accounts created after 31 March 2026).Read-onlyList ITAM Assets
List assets in Freshservice IT Asset Management (accounts created after 31 March 2026). Returns an assets array plus meta with page, per_page and total_count. Use this on newer Freshservice accounts. On older accounts use freshservice_assets_list.
Inputs
include_colsstring- Comma-separated properties to return for each asset, to trim the response. Examples: name, device_id, serial_no, asset_no, type, location, rack, ip_addresses, custom_fields.
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_location_getGet one Freshservice location by ID.Read-onlyGet Location
Get one Freshservice location by ID. Returns the location with name, parent location, contact details and address. Use this when you know the location ID.
Inputs
location_idintegerrequired- Numeric ID of the location.
freshservice_locations_listList Freshservice locations.Read-onlyList Locations
List Freshservice locations. Returns location objects with id, name, parent location, contact and address. Use this to find location IDs for requesters and assets.
Inputs
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
workspace_idinteger- Workspace (client) ID to list locations from. Omit for workspace 2; values must be greater than 1.
freshservice_problem_fields_listList the fields on the Freshservice problem form, including custom fields.Read-onlyList Problem Fields
List the fields on the Freshservice problem form, including custom fields. Returns each field's name, label, type, required flags and allowed choices. Use this to learn valid field names and values before creating or updating problems.
Inputs
workspace_idinteger- ID of the workspace to list problem fields from. Omit to use the primary workspace; pass 0 to return problem fields from every workspace you can access (global fields only). Applies only to accounts that use workspaces.
freshservice_problem_getGet one Freshservice problem by ID.Read-onlyGet Problem
Get one Freshservice problem by ID. Returns the problem object with subject, status, priority, impact, assignee, analysis fields and custom fields. Use this when you know the problem ID. Use freshservice_problems_list to browse.
Inputs
problem_idintegerrequired- Numeric ID of the problem.
freshservice_problem_notes_listList the notes on a Freshservice problem.Read-onlyList Problem Notes
List the notes on a Freshservice problem. Returns note objects with body, author and timestamps. Use this to read the problem's discussion history.
Inputs
problem_idintegerrequired- Numeric ID of the problem.
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_problem_tasks_listList the tasks on a Freshservice problem.Read-onlyList Problem Tasks
List the tasks on a Freshservice problem. Returns task objects with title, status, assignee and due date. Use this to see the work items on a problem.
Inputs
problem_idintegerrequired- Numeric ID of the problem.
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_problems_listList Freshservice problems.Read-onlyList Problems
List Freshservice problems. Returns a page of problem objects (30 by default) under a problems array. Use this to browse problems. Use freshservice_problem_get for one problem.
Inputs
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
workspace_idinteger- ID of the workspace to list problems from. Omit to use the primary workspace; pass 0 to return problems from every workspace you can access (global fields only). Applies only to accounts that use workspaces.
freshservice_products_listList the products (asset models such as MacBook Pro 14) in the Freshservice product catalog.Read-onlyList Products
List the products (asset models such as MacBook Pro 14) in the Freshservice product catalog. Returns product objects with id, name, asset type, manufacturer, status and depreciation. Use this to find product IDs for asset type fields and service items.
Inputs
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_project_getGet one Freshservice project by ID.Read-onlyGet Project
Get one Freshservice project by ID. Returns the project with name, key, description, status, priority, manager, dates and custom fields. Use this when you know the project ID.
Inputs
project_idintegerrequired- Numeric ID of the project.
freshservice_project_task_getGet one task in a Freshservice project.Read-onlyGet Project Task
Get one task in a Freshservice project. Returns the task with title, description, type, status, priority, assignee, planned dates and custom fields. Use this when you know the task ID.
Inputs
project_idintegerrequired- Numeric ID of the project.
task_idintegerrequired- Numeric ID of the project task.
freshservice_project_tasks_listList the tasks in a Freshservice project.Read-onlyList Project Tasks
List the tasks in a Freshservice project. Returns a page of task objects with title, type, status, priority, assignee and planned dates. Use this to see a project's work items. Use freshservice_project_task_get for one task.
Inputs
project_idintegerrequired- Numeric ID of the project.
filterstring- Filter: open or unresolved. By default open and completed tasks are listed.one of
openunresolved pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_projects_listList Freshservice projects (new-gen project management).Read-onlyList Projects
List Freshservice projects (new-gen project management). Returns a page of project objects with id, name, key, status, priority, manager and dates. Use this to browse projects. By default open and completed projects are returned; use filter to narrow.
Inputs
filterstring- Filter: completed, incomplete (open and in progress), archived, open or in_progress.one of
completedincompletearchivedopenin_progress pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_release_fields_listList the fields on the Freshservice release form, including custom fields.Read-onlyList Release Fields
List the fields on the Freshservice release form, including custom fields. Returns each field's name, label, type, required flags and allowed choices. Use this to learn valid field names and values before creating or updating releases.
Inputs
workspace_idinteger- ID of the workspace to list release fields from. Omit to use the primary workspace; pass 0 to return release fields from every workspace you can access (global fields only). Applies only to accounts that use workspaces.
freshservice_release_getGet one Freshservice release by ID.Read-onlyGet Release
Get one Freshservice release by ID. Returns the release object with subject, status, type, planned and actual dates, linked changes and assets. Use this when you know the release ID. Use freshservice_releases_list to browse.
Inputs
release_idintegerrequired- Numeric ID of the release.
freshservice_release_notes_listList the notes on a Freshservice release.Read-onlyList Release Notes
List the notes on a Freshservice release. Returns note objects with body, author and timestamps. Use this to read the release's discussion history.
Inputs
release_idintegerrequired- Numeric ID of the release.
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_release_tasks_listList the tasks on a Freshservice release.Read-onlyList Release Tasks
List the tasks on a Freshservice release. Returns task objects with title, status, assignee and due date. Use this to see the work items on a release.
Inputs
release_idintegerrequired- Numeric ID of the release.
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_releases_listList Freshservice releases, optionally using a predefined filter.Read-onlyList Releases
List Freshservice releases, optionally using a predefined filter. Returns a page of release objects (30 by default) under a releases array. Use this to browse releases. Use freshservice_release_get for one release.
Inputs
filter_namestring- Predefined filter: all, my_open, unassigned, completed, incompleted or deleted.one of
allmy_openunassignedcompletedincompleteddeleted pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
workspace_idinteger- ID of the workspace to list releases from. Omit to use the primary workspace; pass 0 to return releases from every workspace you can access (global fields only). Applies only to accounts that use workspaces.
freshservice_requester_fields_listList the fields on Freshservice requester profiles, including custom fields.Read-onlyList Requester Fields
List the fields on Freshservice requester profiles, including custom fields. Returns each field's name, label, type, required flags and choices. Use this to learn custom field names before creating, updating or filtering requesters.
Inputs
This tool takes no inputs.
freshservice_requester_getGet one Freshservice requester by user ID.Read-onlyGet Requester
Get one Freshservice requester by user ID. Returns the requester object with name, emails, phones, departments, location and custom fields. Use this when you know the ID. Use freshservice_requesters_list to look up by email or phone, or freshservice_requesters_filter for other fields.
Inputs
requester_idintegerrequired- Numeric ID of the requester (user ID).
freshservice_requester_group_getGet one Freshservice requester group by ID.Read-onlyGet Requester Group
Get one Freshservice requester group by ID. Returns the group's name, description and type. Use this to check a requester group's details. Use freshservice_requester_group_members_list for its members.
Inputs
requester_group_idintegerrequired- Numeric ID of the requester group.
freshservice_requester_group_members_listList the members of a Freshservice requester group.Read-onlyList Requester Group Members
List the members of a Freshservice requester group. Returns a page of requester objects (30 by default). Use this to see which end users belong to a group.
Inputs
requester_group_idintegerrequired- Numeric ID of the requester group.
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_requester_groups_listList Freshservice requester groups (sets of end users).Read-onlyList Requester Groups
List Freshservice requester groups (sets of end users). Returns group objects with id, name, description and type (manual or rule_based). Use this to find requester group IDs. Use freshservice_requester_group_members_list to see who is in a group.
Inputs
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
workspace_idinteger- Workspace (client) ID to list groups from. Omit for workspace 2; pass 1 for global groups.
freshservice_requesters_filterFilter Freshservice requesters with a query on requester fields, including starts-with searches.Read-onlyFilter Requesters
Filter Freshservice requesters with a query on requester fields, including starts-with searches. Returns matching requester objects under a requesters array, newest first, 30 per page (page 40 at most). Use this to search requesters by name, title, department, location or dates. Use freshservice_requesters_list for an exact email or phone lookup.
Inputs
querystringrequired- Filter expression for requesters, written without the surrounding double quotes (the tool adds them). Combine conditions as field:value with AND / OR and parentheses; put string and date values in single quotes and numbers bare; use :> and :< for greater-or-equal and less-or-equal. Supported fields: first_name, last_name, name, job_title, primary_email, work_phone_number, mobile_phone_number, department_id, reporting_manager_id, time_zone, language, location_id, created_at, updated_at. Use ~[field1|field2]:'text' for starts-with search and null for empty fields. Example: ~[first_name|primary_email]:'ron'
include_agentsboolean- Set true to include agents in the results (needs the Manage Agents permission).
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
freshservice_requesters_listList Freshservice requesters sorted by first name, optionally matching an exact email or phone number.Read-onlyList Requesters
List Freshservice requesters sorted by first name, optionally matching an exact email or phone number. Returns a page of requester objects (30 by default) under a requesters array. Use this to browse requesters or find one by exact email or phone. Use freshservice_requesters_filter for other fields or starts-with searches.
Inputs
emailstring- Return only the requester with this exact email address.
include_agentsboolean- Set true to include agents as well as requesters in the results.
mobile_phone_numberstring- Return only requesters with this exact mobile phone number.
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
work_phone_numberstring- Return only requesters with this exact work phone number.
freshservice_roles_listList the agent roles defined in Freshservice.Read-onlyList Agent Roles
List the agent roles defined in Freshservice. Returns role objects with id, name, description, default flag and scopes. Use this to see which permission roles exist.
Inputs
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_service_catalog_categories_listList the categories of the Freshservice service catalog.Read-onlyList Service Catalog Categories
List the categories of the Freshservice service catalog. Returns category objects with id, name, description and position. Use this to find category_id for freshservice_service_catalog_items_list.
Inputs
workspace_idinteger- ID of the workspace to list service categories from. Omit to use the primary workspace; pass 0 to return service categories from every workspace you can access (global fields only). Applies only to accounts that use workspaces.
freshservice_service_catalog_item_getGet one Freshservice service catalog item by display ID.Read-onlyGet Service Catalog Item
Get one Freshservice service catalog item by display ID. Returns the item with its description, cost, delivery time and the custom fields its request form needs. Use this before freshservice_service_request_create to see which custom_fields the item requires.
Inputs
display_idintegerrequired- Numeric ID of the service item (its display ID).
freshservice_service_catalog_items_listList the items in the Freshservice service catalog, optionally for one category.Read-onlyList Service Catalog Items
List the items in the Freshservice service catalog, optionally for one category. Returns a page of service item objects with display_id, name, category and delivery time. Use this to browse what can be requested. Use freshservice_service_catalog_items_search to find an item by keyword.
Inputs
category_idinteger- Return only items in this service category. Get IDs from freshservice_service_catalog_categories_list.
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of items per page, up to 30 (the default and maximum for this endpoint).
workspace_idinteger- ID of the workspace to list service items from. Omit to use the primary workspace; pass 0 to return service items from every workspace you can access (global fields only). Applies only to accounts that use workspaces.
freshservice_service_catalog_items_searchSearch published Freshservice service catalog items by keyword.Read-onlySearch Service Catalog Items
Search published Freshservice service catalog items by keyword. Returns matching service items the user can access. Use this to find the item to request. Use freshservice_service_catalog_items_list to browse by category.
Inputs
search_termstringrequired- Keywords to search for. Example: adobe.
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
user_emailstring- Search as this user instead of the API key owner. The API key owner must be allowed to act as that user, or the request returns 403.
workspace_idinteger- ID of the workspace to list service items from. Omit to use the primary workspace; pass 0 to return service items from every workspace you can access (global fields only). Applies only to accounts that use workspaces.
freshservice_sla_policies_listList SLA policies in Freshservice.Read-onlyList SLA Policies
List SLA policies in Freshservice. Returns SLA policies with name, active and default flags, targets per priority, applicable conditions and escalations. Use this to see response and resolution targets.
Inputs
workspace_idinteger- Workspace ID. Omit for global and primary-workspace policies; 1 returns only global policies; a higher ID adds that workspace's policies.
freshservice_software_listList the software applications tracked in Freshservice.Read-onlyList Software
List the software applications tracked in Freshservice. Returns software objects with id, name, category, status, publisher, users count and installation count. Use this to review installed or managed software.
Inputs
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
workspace_idinteger- ID of the workspace to list software from. Omit to use the primary workspace; pass 0 to return software from every workspace you can access (global fields only). Applies only to accounts that use workspaces.
freshservice_solution_article_getGet one Freshservice knowledge base article by ID.Read-onlyGet Solution Article
Get one Freshservice knowledge base article by ID. Returns the article object with title, HTML body, folder, status, tags and view counts. Use this to read an article you found with freshservice_solution_articles_search or freshservice_solution_articles_list.
Inputs
article_idintegerrequired- Numeric ID of the solution article.
freshservice_solution_articles_listList the knowledge base articles in one Freshservice solution folder.Read-onlyList Solution Articles
List the knowledge base articles in one Freshservice solution folder. Returns a page of article objects (30 by default) under an articles array. Use this to browse a folder. Use freshservice_solution_articles_search to find articles by keyword across folders.
Inputs
folder_idintegerrequired- ID of the solution folder whose articles to list. Get IDs from freshservice_solution_folders_list.
filterstring- Set to trash to list deleted articles in the folder.one of
trash pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_solution_articles_searchSearch published Freshservice knowledge base articles by keyword.Read-onlySearch Solution Articles
Search published Freshservice knowledge base articles by keyword. Returns matching article objects the user can access. Use this to find help content for a question. Use freshservice_solution_articles_list to browse one folder.
Inputs
search_termstringrequired- Keywords to search for. Example: vpn issue.
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
user_emailstring- Search as this user instead of the API key owner, so results match what they can see. The API key owner must be allowed to act as that user, or the request returns 403.
freshservice_solution_categories_listList knowledge base (solution) categories in Freshservice.Read-onlyList Solution Categories
List knowledge base (solution) categories in Freshservice. Returns category objects with id, name, description, position and default flag. Use this to browse the knowledge base structure. Use freshservice_solution_folders_list for the folders in a category.
Inputs
filterstring- Set to trash to list deleted categories.one of
trash pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
workspace_idinteger- ID of the workspace to list solution categories from. Omit to use the primary workspace; pass 0 to return solution categories from every workspace you can access (global fields only). Applies only to accounts that use workspaces.
freshservice_solution_folders_listList knowledge base (solution) folders in Freshservice, optionally for one category.Read-onlyList Solution Folders
List knowledge base (solution) folders in Freshservice, optionally for one category. Returns folder objects with id, name, description, category_id and visibility. Use this to find the folder_id for listing or creating articles.
Inputs
category_idinteger- Return only folders in this solution category. Get IDs from freshservice_solution_categories_list.
filterstring- Set to trash to list deleted folders.one of
trash pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_ticket_activities_listList the activity log of a Freshservice ticket: who changed what and when.Read-onlyList Ticket Activities
List the activity log of a Freshservice ticket: who changed what and when. Returns the 20 most recent activities, each with the acting user, the actions performed and a timestamp, plus a token for older entries. Use this to audit a ticket's history. Use freshservice_ticket_conversations_list for replies and notes.
Inputs
ticket_idintegerrequired- Numeric ID of the ticket.
start_tokenstring- Token from a previous response that returns the next 20 older activities. Omit for the most recent 20.
freshservice_ticket_approvals_listList the approval requests on a Freshservice service request.Read-onlyList Ticket Approvals
List the approval requests on a Freshservice service request. Returns approval objects with approver, status, level and timestamps. Use this to check whether a service request is approved. Use freshservice_approvals_list to find approvals across many tickets or changes.
Inputs
ticket_idintegerrequired- Numeric ID of the service request ticket.
freshservice_ticket_conversations_listList the replies and notes on a Freshservice ticket.Read-onlyList Ticket Conversations
List the replies and notes on a Freshservice ticket. Returns a page of conversation objects (30 by default) with body, author, privacy flag and timestamps. Use this to read a ticket's full thread. Use freshservice_ticket_get with include=conversations for only the first ten entries.
Inputs
ticket_idintegerrequired- Numeric ID of the ticket.
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_ticket_csat_response_getGet the customer satisfaction (CSAT) survey response for a Freshservice ticket.Read-onlyGet Ticket CSAT Response
Get the customer satisfaction (CSAT) survey response for a Freshservice ticket. Returns the survey questions and the requester's answers and overall rating. Use this to read feedback on a resolved ticket.
Inputs
ticket_idintegerrequired- Numeric ID of the ticket.
freshservice_ticket_fields_listList the fields on the Freshservice ticket form, including custom fields.Read-onlyList Ticket Fields
List the fields on the Freshservice ticket form, including custom fields. Returns each field's name, label, type, required flags and allowed choices (with nested choices for dependent fields). Use this to learn valid field names and values before creating, updating or filtering tickets.
Inputs
workspace_idinteger- ID of the workspace to list ticket fields from. Omit to use the primary workspace; pass 0 to return ticket fields from every workspace you can access (global fields only). Applies only to accounts that use workspaces.
freshservice_ticket_getGet one Freshservice ticket by ID, optionally embedding related records.Read-onlyGet Ticket
Get one Freshservice ticket by ID, optionally embedding related records. Returns the ticket object with subject, description, status, priority, requester, assignee, dates and custom fields. Use this when you already have the ticket ID. Use freshservice_tickets_list to browse or freshservice_tickets_filter to search by field values.
Inputs
ticket_idintegerrequired- Numeric ID of the ticket. Shown as INC-20 or SR-20 in the Freshservice UI; pass only the number.
includestring- Comma-separated related records to embed in the response. Supported values: conversations, requester, problem, stats, assets, change, related_tickets, tags, requested_for, department, feedback, changes, onboarding_context, offboarding_context, skill, skillset. Each embed costs extra API credits.
freshservice_ticket_requested_items_listList the catalog items requested in a Freshservice service request.Read-onlyList Requested Items
List the catalog items requested in a Freshservice service request. Returns requested item objects with service item ID, quantity, stage (1 Requested, 2 Delivered, 3 Cancelled, 4 Fulfilled, 5 Partially Fulfilled), cost and custom field values. Use this to see what a service request asked for and its fulfilment stage.
Inputs
ticket_idintegerrequired- Numeric ID of the service request ticket.
freshservice_ticket_task_getGet one task on a Freshservice ticket.Read-onlyGet Ticket Task
Get one task on a Freshservice ticket. Returns the task object with title, description, status, assignee and dates. Use this when you know the task ID. Use freshservice_ticket_tasks_list to find it.
Inputs
task_idintegerrequired- Numeric ID of the task.
ticket_idintegerrequired- Numeric ID of the ticket.
freshservice_ticket_tasks_listList the tasks on a Freshservice ticket.Read-onlyList Ticket Tasks
List the tasks on a Freshservice ticket. Returns task objects with title, status, assignee and due date. Use this to see the work items on a ticket. Use freshservice_ticket_task_get for one task.
Inputs
ticket_idintegerrequired- Numeric ID of the ticket.
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_ticket_time_entries_listList the time entries logged on a Freshservice ticket.Read-onlyList Ticket Time Entries
List the time entries logged on a Freshservice ticket. Returns time entry objects with agent, time spent, billable flag, note and timer state. Use this to review effort on a ticket.
Inputs
ticket_idintegerrequired- Numeric ID of the ticket.
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_tickets_filterFilter Freshservice tickets with a query on ticket fields, including custom fields.Read-onlyFilter Tickets
Filter Freshservice tickets with a query on ticket fields, including custom fields. Returns matching ticket objects under a tickets array plus a total count, 30 per page. Use this to find tickets by status, priority, agent, group, tag or dates. Use freshservice_tickets_list for predefined views and freshservice_ticket_get for one known ticket.
Inputs
querystringrequired- Filter expression for tickets, written without the surrounding double quotes (the tool adds them). Combine conditions as field:value with AND / OR and parentheses; put string and date values in single quotes and numbers bare; use :> and :< for greater-or-equal and less-or-equal. Supported fields: workspace_id, requester_id, email, agent_id, group_id, priority, status, impact, urgency, tag, due_by, fr_due_by, created_at, updated_at, and custom fields by their snake_case name. Example: priority:3 AND status:2
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
freshservice_tickets_listList Freshservice tickets, newest first, with optional predefined filters, requester, type and date limits.Read-onlyList Tickets
List Freshservice tickets, newest first, with optional predefined filters, requester, type and date limits. Returns a page of ticket objects (30 by default) under a tickets array. Use this to browse recent tickets. By default only tickets created in the last 30 days are returned; set updated_since for older ones. Use freshservice_tickets_filter for field-based queries.
Inputs
emailstring- Return only tickets raised by the requester with this email address.
filterstring- Predefined filter to apply: new_and_my_open (new and my open tickets), watching (tickets I watch), spam, or deleted.one of
new_and_my_openwatchingspamdeleted includestring- Comma-separated related records to embed for each ticket: requester, stats, tags, requested_for, department, created_by, onboarding_context, offboarding_context, skill, skillset. Each embed costs extra API credits.
order_typestring- Sort order by creation time: asc or desc. Defaults to desc.one of
ascdesc pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
requester_idinteger- Return only tickets raised by this requester user ID.
typestring- Return only tickets of this type: Incident or Service Request.one of
IncidentService Request updated_sincestring- Return tickets updated at or after this ISO 8601 datetime. Use it to reach tickets older than the default 30-day window. Example: 2026-01-01T00:00:00Z.
workspace_idinteger- ID of the workspace to list tickets from. Omit to use the primary workspace; pass 0 to return tickets from every workspace you can access (global fields only). Applies only to accounts that use workspaces.
freshservice_vendors_listList the vendors recorded in Freshservice.Read-onlyList Vendors
List the vendors recorded in Freshservice. Returns vendor objects with id, name, description, contact and address. Use this to find vendor IDs for assets, software and contracts.
Inputs
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_workspaces_listList the workspaces (or clients, in MSP mode) in the Freshservice account.Read-onlyList Workspaces
List the workspaces (or clients, in MSP mode) in the Freshservice account. Returns workspace objects with id, name, state, primary flag and, for MSPs, client metadata. Use this to find the workspace_id to pass to other tools. ID 2 is usually the primary workspace.
Inputs
pageinteger- Page number of results to return, starting at 1. Freshservice returns up to per_page records per page; request the next page while the previous one came back full.
per_pageinteger- Number of records per page, from 1 to 100. Freshservice defaults to 30 when omitted; values above 100 return an error.
freshservice_asset_createCreate an asset (laptop, server, licence and so on) in Freshservice.WriteCreate Asset
Create an asset (laptop, server, licence and so on) in Freshservice. Returns the created asset object with its id and display_id. Use this to register a new asset. This is the classic Assets API, for Freshservice accounts created before 31 March 2026; newer accounts use the ITAM tools (freshservice_itam_assets_list).
Inputs
asset_type_idintegerrequired- ID of the asset type. Get IDs from freshservice_asset_types_list.
namestringrequired- Name of the asset. Example: MacBook Pro 14 - J.Doe.
agent_idinteger- User ID of the agent who manages the asset (Managed By).
asset_tagstring- Asset tag. Example: ASSET-9.
assigned_onstring- Time the asset was assigned, as an ISO 8601 datetime.
department_idinteger- ID of the asset's department.
descriptionstring- Description of the asset.
group_idinteger- ID of the agent group that manages the asset.
impactstring- Business impact of the asset: low, medium or high. Defaults to low.one of
lowmediumhigh location_idinteger- ID of the asset's location.
type_fieldsobject- Values for fields specific to the asset type, keyed by field name with the asset type ID as suffix (see freshservice_asset_type_fields_list). Example: {"product_25": 10, "vendor_25": 14, "serial_number_25": "SW12131133", "asset_state_25": "In Use"}
usage_typestring- Usage type: permanent or loaner. Defaults to permanent.one of
permanentloaner user_idinteger- User ID of the person who uses the asset (Used By).
workspace_idinteger- ID of the workspace the asset belongs to. Omit to use the primary workspace. Applies only to accounts that use workspaces; it cannot be changed later with an update.
freshservice_asset_updateUpdate an existing Freshservice asset, for example its user, location, state or type fields.WriteUpdate Asset
Update an existing Freshservice asset, for example its user, location, state or type fields. Returns the updated asset object. Use this to reassign or edit an asset. This is the classic Assets API, for Freshservice accounts created before 31 March 2026; newer accounts use the ITAM tools (freshservice_itam_assets_list).
- Idempotent
Inputs
display_idintegerrequired- Numeric ID of the asset to update (its display ID).
agent_idinteger- User ID of the agent who manages the asset (Managed By).
asset_tagstring- Asset tag. Example: ASSET-9.
asset_type_idinteger- ID of the asset type. Get IDs from freshservice_asset_types_list.
assigned_onstring- Time the asset was assigned, as an ISO 8601 datetime.
department_idinteger- ID of the asset's department.
descriptionstring- Description of the asset.
group_idinteger- ID of the agent group that manages the asset.
impactstring- Business impact of the asset: low, medium or high. Defaults to low.one of
lowmediumhigh location_idinteger- ID of the asset's location.
namestring- Name of the asset. Example: MacBook Pro 14 - J.Doe.
type_fieldsobject- Values for fields specific to the asset type, keyed by field name with the asset type ID as suffix (see freshservice_asset_type_fields_list). Example: {"product_25": 10, "vendor_25": 14, "serial_number_25": "SW12131133", "asset_state_25": "In Use"}
usage_typestring- Usage type: permanent or loaner. Defaults to permanent.one of
permanentloaner user_idinteger- User ID of the person who uses the asset (Used By).
freshservice_change_createCreate a change request in Freshservice.WriteCreate Change
Create a change request in Freshservice. Returns the created change object with its id. Use this to plan and track a change to IT infrastructure. Use freshservice_release_create for a release that bundles changes. Identify the requester with email or requester_id.
Inputs
change_typeintegerrequired- Change type: 1 = Minor, 2 = Standard, 3 = Major, 4 = Emergency.one of
1234 descriptionstringrequired- Description of the change in HTML. Plain text also works.
impactintegerrequired- Change impact: 1 = Low, 2 = Medium, 3 = High.one of
123 priorityintegerrequired- Change priority: 1 = Low, 2 = Medium, 3 = High, 4 = Urgent.one of
1234 riskintegerrequired- Change risk: 1 = Low, 2 = Medium, 3 = High, 4 = Very High.one of
1234 statusintegerrequired- Change status: 1 = Open, 2 = Planning, 3 = Approval,4 = Pending Release, 5 = Pending Review, 6 = Closed.one of
123456 subjectstringrequired- Subject of the change. Example: Replace email server ES3.
agent_idinteger- User ID of the agent the change is assigned to.
assetsarray- Assets to associate, each given by its display ID. Example: [{"display_id": 8}].
categorystring- Change category, matching a configured category value.
custom_fieldsobject- Values for custom change fields, keyed by each field's internal name (snake_case, as returned by the matching list-fields tool). Example: {"custom_text": "Value"}
department_idinteger- ID of the department initiating the change.
emailstring- Email address of the person requesting the change. Provide email or requester_id.
group_idinteger- ID of the agent group the change is assigned to.
item_categorystring- Change item category.
maintenance_windowobject- Maintenance window to associate, given by its ID. Only the ID is accepted through the API. Example: {"id": 1}
planned_end_datestring- Planned end of the change as an ISO 8601 datetime.
planned_start_datestring- Planned start of the change as an ISO 8601 datetime.
requester_idinteger- User ID of the person who initiated the change, used instead of email.
sub_categorystring- Change sub-category.
workspace_idinteger- ID of the workspace the change belongs to. Omit to use the primary workspace. Applies only to accounts that use workspaces; it cannot be changed later with an update.
freshservice_change_note_createAdd a note to a Freshservice change.WriteAdd Note to Change
Add a note to a Freshservice change. Returns the created note with its id, body and author. Use this to record investigation updates on the change.
Inputs
bodystringrequired- Content of the note in HTML. Plain text also works. Example: <div>Rebooted the mail relay; monitoring for 30 minutes.</div>
change_idintegerrequired- Numeric ID of the change.
notify_emailsarray- Email addresses to notify about the note. Example: ["cab@example.com"].
freshservice_change_task_createCreate a task on a Freshservice change and optionally assign it.WriteCreate Change Task
Create a task on a Freshservice change and optionally assign it. Returns the created task object with its id. Use this to track work items for the change. Use freshservice_change_task_update to change or complete it.
Inputs
change_idintegerrequired- Numeric ID of the change.
titlestringrequired- Title of the task. Example: Replace failing disk on ES3.
agent_idinteger- User ID of the agent the task is assigned to. Get agent IDs from freshservice_agents_list.
descriptionstring- Longer description of the work to be done in the task.
due_datestring- Due date of the task as an ISO 8601 datetime, for example 2026-11-01T17:00:00Z.
group_idinteger- ID of the agent group the task is assigned to. Get group IDs from freshservice_agent_groups_list.
notify_beforeinteger- How many seconds before the due date Freshservice sends a reminder. 0 sends no early reminder; 3600 reminds one hour before.
statusinteger- Status of the task: 1 = Open, 2 = In Progress, 3 = Completed.one of
123 workspace_idinteger- ID of the workspace the task belongs to. Omit to use the workspace of the parent change. Applies only to accounts that use workspaces.
freshservice_change_task_updateUpdate a task on a Freshservice change, for example its status or assignee.WriteUpdate Change Task
Update a task on a Freshservice change, for example its status or assignee. Returns the updated task object. Use this to progress or complete a change task (status 3 = Completed).
- Idempotent
Inputs
change_idintegerrequired- Numeric ID of the change.
task_idintegerrequired- Numeric ID of the task to update.
agent_idinteger- User ID of the agent the task is assigned to. Get agent IDs from freshservice_agents_list.
descriptionstring- Longer description of the work to be done in the task.
due_datestring- Due date of the task as an ISO 8601 datetime, for example 2026-11-01T17:00:00Z.
group_idinteger- ID of the agent group the task is assigned to. Get group IDs from freshservice_agent_groups_list.
notify_beforeinteger- How many seconds before the due date Freshservice sends a reminder. 0 sends no early reminder; 3600 reminds one hour before.
statusinteger- Status of the task: 1 = Open, 2 = In Progress, 3 = Completed.one of
123 titlestring- Title of the task. Example: Replace failing disk on ES3.
freshservice_change_updateUpdate an existing Freshservice change, for example its status, risk or planned dates.WriteUpdate Change
Update an existing Freshservice change, for example its status, risk or planned dates. Returns the updated change object. Use this to move a change through its lifecycle. Use freshservice_change_note_create to add notes.
- Idempotent
Inputs
change_idintegerrequired- Numeric ID of the change to update.
agent_idinteger- User ID of the agent the change is assigned to.
assetsarray- Assets to associate, each given by its display ID. Example: [{"display_id": 8}].
categorystring- Change category, matching a configured category value.
change_typeinteger- Change type: 1 = Minor, 2 = Standard, 3 = Major, 4 = Emergency.one of
1234 custom_fieldsobject- Values for custom change fields, keyed by each field's internal name (snake_case, as returned by the matching list-fields tool). Example: {"custom_text": "Value"}
department_idinteger- ID of the department initiating the change.
descriptionstring- Description of the change in HTML. Plain text also works.
group_idinteger- ID of the agent group the change is assigned to.
impactinteger- Change impact: 1 = Low, 2 = Medium, 3 = High.one of
123 item_categorystring- Change item category.
maintenance_windowobject- Maintenance window to associate, given by its ID. Only the ID is accepted through the API. Example: {"id": 1}
planned_end_datestring- Planned end of the change as an ISO 8601 datetime.
planned_start_datestring- Planned start of the change as an ISO 8601 datetime.
priorityinteger- Change priority: 1 = Low, 2 = Medium, 3 = High, 4 = Urgent.one of
1234 requester_idinteger- User ID of the person who initiated the change, used instead of email.
riskinteger- Change risk: 1 = Low, 2 = Medium, 3 = High, 4 = Very High.one of
1234 statusinteger- Change status: 1 = Open, 2 = Planning, 3 = Approval,4 = Pending Release, 5 = Pending Review, 6 = Closed.one of
123456 sub_categorystring- Change sub-category.
subjectstring- Subject of the change. Example: Replace email server ES3.
freshservice_conversation_updateEdit the body of a note on a Freshservice ticket.WriteUpdate Conversation
Edit the body of a note on a Freshservice ticket. Returns the updated conversation object. Use this to correct a public or private note. Replies already sent cannot be edited. Get the conversation ID from freshservice_ticket_conversations_list.
- Idempotent
Inputs
bodystringrequired- New content of the note in HTML. Plain text also works.
conversation_idintegerrequired- Numeric ID of the conversation (note).
freshservice_problem_createCreate a problem record in Freshservice to track the root cause behind one or more incidents.WriteCreate Problem
Create a problem record in Freshservice to track the root cause behind one or more incidents. Returns the created problem object with its id. Use this for underlying causes. Use freshservice_ticket_create for an individual incident. Identify the initiator with email or requester_id.
Inputs
descriptionstringrequired- Description of the problem in HTML. Plain text also works.
due_bystringrequired- Time the problem is due to be resolved, as an ISO 8601 datetime.
impactintegerrequired- Problem impact: 1 = Low, 2 = Medium, 3 = High.one of
123 priorityintegerrequired- Problem priority: 1 = Low, 2 = Medium, 3 = High, 4 = Urgent.one of
1234 statusintegerrequired- Problem status: 1 = Open, 2 = Change Requested, 3 = Closed.one of
123 subjectstringrequired- Subject of the problem. Example: Recurring outages on email server ES3.
agent_idinteger- User ID of the agent the problem is assigned to.
analysis_fieldsobject- Root-cause analysis text. Each entry (problem_cause, problem_symptom, problem_impact) is an object with a description. Example: {"problem_cause": {"description": "Faulty power supply"}}
assetsarray- Assets to associate, each given by its display ID. Example: [{"display_id": 8}].
categorystring- Problem category, matching a configured category value. Example: Hardware.
custom_fieldsobject- Values for custom problem fields, keyed by each field's internal name (snake_case, as returned by the matching list-fields tool). Example: {"custom_text": "Value"}
department_idinteger- ID of the department initiating the problem.
emailstring- Email address of the person reporting the problem. Provide email or requester_id.
group_idinteger- ID of the agent group the problem is assigned to.
item_categorystring- Problem item category. Example: Router.
known_errorboolean- Whether the problem is a known error.
requester_idinteger- User ID of the person who initiated the problem, used instead of email.
sub_categorystring- Problem sub-category. Example: Peripherals.
workspace_idinteger- ID of the workspace the problem belongs to. Omit to use the primary workspace. Applies only to accounts that use workspaces; it cannot be changed later with an update.
freshservice_problem_note_createAdd a note to a Freshservice problem.WriteAdd Note to Problem
Add a note to a Freshservice problem. Returns the created note with its id, body and author. Use this to record investigation updates on the problem.
Inputs
bodystringrequired- Content of the note in HTML. Plain text also works. Example: <div>Rebooted the mail relay; monitoring for 30 minutes.</div>
problem_idintegerrequired- Numeric ID of the problem.
notify_emailsarray- Email addresses to notify about the note. Example: ["cab@example.com"].
freshservice_problem_task_createCreate a task on a Freshservice problem and optionally assign it.WriteCreate Problem Task
Create a task on a Freshservice problem and optionally assign it. Returns the created task object with its id. Use this to track work items for the problem. Use freshservice_problem_task_update to change or complete it.
Inputs
problem_idintegerrequired- Numeric ID of the problem.
titlestringrequired- Title of the task. Example: Replace failing disk on ES3.
agent_idinteger- User ID of the agent the task is assigned to. Get agent IDs from freshservice_agents_list.
descriptionstring- Longer description of the work to be done in the task.
due_datestring- Due date of the task as an ISO 8601 datetime, for example 2026-11-01T17:00:00Z.
group_idinteger- ID of the agent group the task is assigned to. Get group IDs from freshservice_agent_groups_list.
notify_beforeinteger- How many seconds before the due date Freshservice sends a reminder. 0 sends no early reminder; 3600 reminds one hour before.
statusinteger- Status of the task: 1 = Open, 2 = In Progress, 3 = Completed.one of
123 workspace_idinteger- ID of the workspace the task belongs to. Omit to use the workspace of the parent problem. Applies only to accounts that use workspaces.
freshservice_problem_task_updateUpdate a task on a Freshservice problem, for example its status or assignee.WriteUpdate Problem Task
Update a task on a Freshservice problem, for example its status or assignee. Returns the updated task object. Use this to progress or complete a problem task (status 3 = Completed).
- Idempotent
Inputs
problem_idintegerrequired- Numeric ID of the problem.
task_idintegerrequired- Numeric ID of the task to update.
agent_idinteger- User ID of the agent the task is assigned to. Get agent IDs from freshservice_agents_list.
descriptionstring- Longer description of the work to be done in the task.
due_datestring- Due date of the task as an ISO 8601 datetime, for example 2026-11-01T17:00:00Z.
group_idinteger- ID of the agent group the task is assigned to. Get group IDs from freshservice_agent_groups_list.
notify_beforeinteger- How many seconds before the due date Freshservice sends a reminder. 0 sends no early reminder; 3600 reminds one hour before.
statusinteger- Status of the task: 1 = Open, 2 = In Progress, 3 = Completed.one of
123 titlestring- Title of the task. Example: Replace failing disk on ES3.
freshservice_problem_updateUpdate an existing Freshservice problem, for example its status, priority or assignee.WriteUpdate Problem
Update an existing Freshservice problem, for example its status, priority or assignee. Returns the updated problem object. Use this to change problem fields. Use freshservice_problem_note_create to add notes.
- Idempotent
Inputs
problem_idintegerrequired- Numeric ID of the problem to update.
agent_idinteger- User ID of the agent the problem is assigned to.
analysis_fieldsobject- Root-cause analysis text. Each entry (problem_cause, problem_symptom, problem_impact) is an object with a description. Example: {"problem_cause": {"description": "Faulty power supply"}}
assetsarray- Assets to associate, each given by its display ID. Example: [{"display_id": 8}].
categorystring- Problem category, matching a configured category value. Example: Hardware.
custom_fieldsobject- Values for custom problem fields, keyed by each field's internal name (snake_case, as returned by the matching list-fields tool). Example: {"custom_text": "Value"}
department_idinteger- ID of the department initiating the problem.
descriptionstring- Description of the problem in HTML. Plain text also works.
due_bystring- Time the problem is due to be resolved, as an ISO 8601 datetime.
group_idinteger- ID of the agent group the problem is assigned to.
impactinteger- Problem impact: 1 = Low, 2 = Medium, 3 = High.one of
123 item_categorystring- Problem item category. Example: Router.
known_errorboolean- Whether the problem is a known error.
priorityinteger- Problem priority: 1 = Low, 2 = Medium, 3 = High, 4 = Urgent.one of
1234 requester_idinteger- User ID of the person who initiated the problem, used instead of email.
statusinteger- Problem status: 1 = Open, 2 = Change Requested, 3 = Closed.one of
123 sub_categorystring- Problem sub-category. Example: Peripherals.
subjectstring- Subject of the problem. Example: Recurring outages on email server ES3.
freshservice_project_createCreate a project in Freshservice project management.WriteCreate Project
Create a project in Freshservice project management. Returns the created project object with its id and key. Use this to start tracking a new initiative. Add work with freshservice_project_task_create.
Inputs
namestringrequired- Name of the project, up to 255 characters.
project_typeintegerrequired- Project type: 0 = Software project, 1 = Business project.one of
01 custom_fieldsobject- Values for custom project fields keyed by field name. Example: {"custom_text": "Value"}
descriptionstring- Description of the project in plain text or HTML.
end_datestring- End date in yyyy-mm-dd format. Defaults to 10 days after creation.
keystring- Project key: starts with a letter, letters and digits only, up to 10 characters. Generated from the name when omitted on create.
manager_idinteger- User ID of the project manager. Defaults to the creator.
priority_idinteger- Project priority: 1 = Low, 2 = Medium, 3 = High, 4 = Urgent. Defaults to 2 on create.one of
1234 project_template_idinteger- ID of a project template to create the project from. Get IDs from the Freshservice project templates.
sprint_durationinteger- Sprint length in days. Defaults to 14.
start_datestring- Start date in yyyy-mm-dd format. Defaults to the creation date.
visibilityinteger- Visibility: 0 = Private, 1 = Public. Defaults to 1.one of
01
freshservice_project_task_createCreate a task in a Freshservice project.WriteCreate Project Task
Create a task in a Freshservice project. Returns the created task object with its id. Use this to add work to a project. Task type, status and priority IDs are project-specific.
Inputs
project_idintegerrequired- Numeric ID of the project.
titlestringrequired- Title of the task.
type_idintegerrequired- ID of the task type (for example epic, story or task) in this project.
assignee_idinteger- User ID of the person the task is assigned to.
custom_fieldsobject- Values for custom task fields keyed by field name. Example: {"custom_text": "Value"}
descriptionstring- Description of the task in plain text or HTML.
parent_idinteger- ID of the parent task (for subtasks) or the epic or task list the task belongs to.
planned_effortstring- Planned effort in the form '1w 2d 3h 4m'.
planned_end_datestring- Planned end as yyyy-mm-ddThh:mm:ssZ.
planned_start_datestring- Planned start as yyyy-mm-ddThh:mm:ssZ.
priority_idinteger- ID of the task priority in this project.
reporter_idinteger- User ID of the person reporting the task. Defaults to the creator.
sprint_idinteger- ID of the sprint to place the task in.
status_idinteger- ID of the task status in this project. Defaults to Open on create.
story_pointsinteger- Story points for the task, where the task type supports them.
version_idinteger- ID of the version the task belongs to.
freshservice_project_task_updateUpdate a task in a Freshservice project, for example its status, assignee or dates.WriteUpdate Project Task
Update a task in a Freshservice project, for example its status, assignee or dates. Returns the updated task object. Use this to progress or re-plan a project task.
- Idempotent
Inputs
project_idintegerrequired- Numeric ID of the project.
task_idintegerrequired- Numeric ID of the project task to update.
assignee_idinteger- User ID of the person the task is assigned to.
custom_fieldsobject- Values for custom task fields keyed by field name. Example: {"custom_text": "Value"}
descriptionstring- Description of the task in plain text or HTML.
parent_idinteger- ID of the parent task (for subtasks) or the epic or task list the task belongs to.
planned_durationstring- Planned duration in the form '1w 3d'. Changing only the duration also moves the planned end date.
planned_effortstring- Planned effort in the form '1w 2d 3h 4m'.
planned_end_datestring- Planned end as yyyy-mm-ddThh:mm:ssZ.
planned_start_datestring- Planned start as yyyy-mm-ddThh:mm:ssZ.
priority_idinteger- ID of the task priority in this project.
sprint_idinteger- ID of the sprint to place the task in.
status_idinteger- ID of the task status in this project. Defaults to Open on create.
story_pointsinteger- Story points for the task, where the task type supports them.
titlestring- Title of the task.
version_idinteger- ID of the version the task belongs to.
freshservice_project_updateUpdate a Freshservice project, for example its status, manager or dates.WriteUpdate Project
Update a Freshservice project, for example its status, manager or dates. Returns the updated project object. Use this to progress or re-plan a project.
- Idempotent
Inputs
project_idintegerrequired- Numeric ID of the project to update.
custom_fieldsobject- Values for custom project fields keyed by field name. Example: {"custom_text": "Value"}
descriptionstring- Description of the project in plain text or HTML.
end_datestring- End date in yyyy-mm-dd format. Defaults to 10 days after creation.
keystring- Project key: starts with a letter, letters and digits only, up to 10 characters. Generated from the name when omitted on create.
manager_idinteger- User ID of the project manager. Defaults to the creator.
namestring- Name of the project, up to 255 characters.
priority_idinteger- Project priority: 1 = Low, 2 = Medium, 3 = High, 4 = Urgent. Defaults to 2 on create.one of
1234 sprint_durationinteger- Sprint length in days. Defaults to 14.
start_datestring- Start date in yyyy-mm-dd format. Defaults to the creation date.
status_idinteger- Project status: 1 = Yet to start, 2 = In Progress, 3 = Completed.one of
123 visibilityinteger- Visibility: 0 = Private, 1 = Public. Defaults to 1.one of
01
freshservice_release_createCreate a release in Freshservice to plan the rollout of one or more changes.WriteCreate Release
Create a release in Freshservice to plan the rollout of one or more changes. Returns the created release object with its id. Use this to schedule a rollout. Use freshservice_change_create for a single change.
Inputs
descriptionstringrequired- Description of the release in HTML. Plain text also works.
planned_end_datestringrequired- Planned end of the release as an ISO 8601 datetime.
planned_start_datestringrequired- Planned start of the release as an ISO 8601 datetime.
priorityintegerrequired- Release priority: 1 = Low, 2 = Medium, 3 = High, 4 = Urgent.one of
1234 release_typeintegerrequired- Release type: 1 = Minor, 2 = Standard, 3 = Major, 4 = Emergency.one of
1234 statusintegerrequired- Release status: 1 = Open, 2 = On Hold, 3 = In Progress, 4 = Incomplete, 5 = Completed.one of
12345 subjectstringrequired- Subject of the release. Example: Q4 laptop OS rollout.
agent_idinteger- User ID of the agent the release is assigned to.
assetsarray- Assets to associate, each given by its display ID. Example: [{"display_id": 8}].
categorystring- Release category, matching a configured category value.
custom_fieldsobject- Values for custom release fields, keyed by each field's internal name (snake_case, as returned by the matching list-fields tool). Example: {"custom_text": "Value"}
department_idinteger- ID of the department initiating the release.
group_idinteger- ID of the agent group the release is assigned to.
item_categorystring- Release item category.
sub_categorystring- Release sub-category.
workspace_idinteger- ID of the workspace the release belongs to. Omit to use the primary workspace. Applies only to accounts that use workspaces; it cannot be changed later with an update.
freshservice_release_note_createAdd a note to a Freshservice release.WriteAdd Note to Release
Add a note to a Freshservice release. Returns the created note with its id, body and author. Use this to record investigation updates on the release.
Inputs
bodystringrequired- Content of the note in HTML. Plain text also works. Example: <div>Rebooted the mail relay; monitoring for 30 minutes.</div>
release_idintegerrequired- Numeric ID of the release.
notify_emailsarray- Email addresses to notify about the note. Example: ["cab@example.com"].
freshservice_release_task_createCreate a task on a Freshservice release and optionally assign it.WriteCreate Release Task
Create a task on a Freshservice release and optionally assign it. Returns the created task object with its id. Use this to track work items for the release. Use freshservice_release_task_update to change or complete it.
Inputs
release_idintegerrequired- Numeric ID of the release.
titlestringrequired- Title of the task. Example: Replace failing disk on ES3.
agent_idinteger- User ID of the agent the task is assigned to. Get agent IDs from freshservice_agents_list.
descriptionstring- Longer description of the work to be done in the task.
due_datestring- Due date of the task as an ISO 8601 datetime, for example 2026-11-01T17:00:00Z.
group_idinteger- ID of the agent group the task is assigned to. Get group IDs from freshservice_agent_groups_list.
notify_beforeinteger- How many seconds before the due date Freshservice sends a reminder. 0 sends no early reminder; 3600 reminds one hour before.
statusinteger- Status of the task: 1 = Open, 2 = In Progress, 3 = Completed.one of
123 workspace_idinteger- ID of the workspace the task belongs to. Omit to use the workspace of the parent release. Applies only to accounts that use workspaces.
freshservice_release_task_updateUpdate a task on a Freshservice release, for example its status or assignee.WriteUpdate Release Task
Update a task on a Freshservice release, for example its status or assignee. Returns the updated task object. Use this to progress or complete a release task (status 3 = Completed).
- Idempotent
Inputs
release_idintegerrequired- Numeric ID of the release.
task_idintegerrequired- Numeric ID of the task to update.
agent_idinteger- User ID of the agent the task is assigned to. Get agent IDs from freshservice_agents_list.
descriptionstring- Longer description of the work to be done in the task.
due_datestring- Due date of the task as an ISO 8601 datetime, for example 2026-11-01T17:00:00Z.
group_idinteger- ID of the agent group the task is assigned to. Get group IDs from freshservice_agent_groups_list.
notify_beforeinteger- How many seconds before the due date Freshservice sends a reminder. 0 sends no early reminder; 3600 reminds one hour before.
statusinteger- Status of the task: 1 = Open, 2 = In Progress, 3 = Completed.one of
123 titlestring- Title of the task. Example: Replace failing disk on ES3.
freshservice_release_updateUpdate an existing Freshservice release, for example its status or dates.WriteUpdate Release
Update an existing Freshservice release, for example its status or dates. Returns the updated release object. Use this to move a release forward or record actual work dates.
- Idempotent
Inputs
release_idintegerrequired- Numeric ID of the release to update.
agent_idinteger- User ID of the agent the release is assigned to.
assetsarray- Assets to associate, each given by its display ID. Example: [{"display_id": 8}].
categorystring- Release category, matching a configured category value.
custom_fieldsobject- Values for custom release fields, keyed by each field's internal name (snake_case, as returned by the matching list-fields tool). Example: {"custom_text": "Value"}
department_idinteger- ID of the department initiating the release.
descriptionstring- Description of the release in HTML. Plain text also works.
group_idinteger- ID of the agent group the release is assigned to.
item_categorystring- Release item category.
planned_end_datestring- Planned end of the release as an ISO 8601 datetime.
planned_start_datestring- Planned start of the release as an ISO 8601 datetime.
priorityinteger- Release priority: 1 = Low, 2 = Medium, 3 = High, 4 = Urgent.one of
1234 release_typeinteger- Release type: 1 = Minor, 2 = Standard, 3 = Major, 4 = Emergency.one of
1234 statusinteger- Release status: 1 = Open, 2 = On Hold, 3 = In Progress, 4 = Incomplete, 5 = Completed.one of
12345 sub_categorystring- Release sub-category.
subjectstring- Subject of the release. Example: Q4 laptop OS rollout.
work_end_datestring- Time work on the release actually ended, as an ISO 8601 datetime.
work_start_datestring- Time work on the release actually started, as an ISO 8601 datetime.
freshservice_requester_createCreate a requester (an end user who raises tickets) in Freshservice.WriteCreate Requester
Create a requester (an end user who raises tickets) in Freshservice. Returns the created requester object with its user id. Use this to add a new end user. Provide first_name and at least one of primary_email, work_phone_number or mobile_phone_number.
Inputs
first_namestringrequired- First name of the requester.
addressstring- Postal address of the requester.
background_informationstring- Background notes about the requester.
can_see_all_tickets_from_associated_departmentsboolean- Whether the requester can view tickets raised by other members of their departments.
custom_fieldsobject- Values for custom requester fields, keyed by each field's internal name (snake_case, as returned by the matching list-fields tool). Example: {"employee_id": "E-1042"}
department_idsarray- IDs of the departments the requester belongs to. Example: [554].
job_titlestring- Job title of the requester.
languagestring- Language code for the requester. Defaults to en.
last_namestring- Last name of the requester.
location_idinteger- ID of the requester's location. Get IDs from freshservice_locations_list.
mobile_phone_numberstring- Mobile phone number of the requester.
primary_emailstring- Primary email address of the requester. On create, provide at least one of primary_email, work_phone_number or mobile_phone_number.
reporting_manager_idinteger- User ID of the requester's reporting manager.
secondary_emailsarray- Additional email addresses for the requester. Example: ["ron@personal.example"].
time_formatstring- Time format: 12h or 24h.one of
12h24h time_zonestring- Time zone name, as listed in Freshservice (for example Eastern Time (US & Canada) or Edinburgh).
work_phone_numberstring- Work phone number of the requester.
freshservice_requester_updateUpdate a Freshservice requester's profile.WriteUpdate Requester
Update a Freshservice requester's profile. Returns the updated requester object. Use this to change contact details, department or manager. Fields you omit keep their values, except can_see_all_tickets_from_associated_departments, which resets to false unless sent as true.
- Idempotent
Inputs
requester_idintegerrequired- Numeric ID of the requester to update (user ID).
addressstring- Postal address of the requester.
background_informationstring- Background notes about the requester.
can_see_all_tickets_from_associated_departmentsboolean- Whether the requester can view tickets raised by other members of their departments. On update this resets to false unless you send true.
custom_fieldsobject- Values for custom requester fields, keyed by each field's internal name (snake_case, as returned by the matching list-fields tool). Example: {"employee_id": "E-1042"}
department_idsarray- IDs of the departments the requester belongs to. Example: [554].
first_namestring- First name of the requester.
job_titlestring- Job title of the requester.
languagestring- Language code for the requester. Defaults to en.
last_namestring- Last name of the requester.
location_idinteger- ID of the requester's location. Get IDs from freshservice_locations_list.
mobile_phone_numberstring- Mobile phone number of the requester.
primary_emailstring- Primary email address of the requester. On create, provide at least one of primary_email, work_phone_number or mobile_phone_number.
reporting_manager_idinteger- User ID of the requester's reporting manager.
secondary_emailsarray- Additional email addresses for the requester. Example: ["ron@personal.example"].
time_formatstring- Time format: 12h or 24h.one of
12h24h time_zonestring- Time zone name, as listed in Freshservice (for example Eastern Time (US & Canada) or Edinburgh).
work_phone_numberstring- Work phone number of the requester.
freshservice_service_request_createPlace a service request for a Freshservice service catalog item.WriteCreate Service Request
Place a service request for a Freshservice service catalog item. Returns the created service request ticket, including requested_items and approval status. Use this to order a catalog item such as software or hardware. Use freshservice_ticket_create to report an incident. Get the item's display ID and required custom fields from freshservice_service_catalog_item_get.
Inputs
display_idintegerrequired- Numeric ID of the service catalog item to request (its display ID).
child_itemsarray- Child service items to include in the same request, each identified by its display ID as service_item_id. Example: [{"service_item_id": 21, "quantity": 1}]
custom_fieldsobject- Values for custom service item form fields, keyed by each field's internal name (snake_case, as returned by the matching list-fields tool). Example: {"needed_by": "2026-11-01"}
emailstring- Email of the requester. If omitted, the request is raised on behalf of the agent who owns the API key.
quantityinteger- Number of units requested. Defaults to 1.
requested_forstring- Email of the person the request is for, when different from the requester.
workspace_idinteger- Workspace ID (2 or higher) to raise the request in. Applies only to accounts that use workspaces.
freshservice_solution_article_createCreate a knowledge base (solution) article in a Freshservice folder.WriteCreate Solution Article
Create a knowledge base (solution) article in a Freshservice folder. Returns the created article object with its id. Use this to publish or draft help content. Set status to 2 to publish immediately, or 1 to save a draft.
Inputs
descriptionstringrequired- Body of the article in HTML.
folder_idintegerrequired- ID of the solution folder the article belongs to. Get IDs from freshservice_solution_folders_list.
titlestringrequired- Title of the article. Example: How to reset your VPN password.
article_typeinteger- Article type: 1 = Permanent, 2 = Workaround.one of
12 keywordsarray- Search keywords for the article. Example: ["password", "reset"].
review_datestring- Future date when the article should be reviewed again, as an ISO 8601 datetime.
statusinteger- Article status: 1 = Draft, 2 = Published.one of
12 tagsarray- Tags for the article. Example: ["vpn"].
freshservice_solution_article_updateUpdate a Freshservice knowledge base article, including publishing it.WriteUpdate Solution Article
Update a Freshservice knowledge base article, including publishing it. Returns the updated article object. Use this to edit content or set status to 2 to publish a draft.
- Idempotent
Inputs
article_idintegerrequired- Numeric ID of the solution article to update.
article_typeinteger- Article type: 1 = Permanent, 2 = Workaround.one of
12 descriptionstring- Body of the article in HTML.
folder_idinteger- ID of the solution folder the article belongs to. Get IDs from freshservice_solution_folders_list.
keywordsarray- Search keywords for the article. Example: ["password", "reset"].
review_datestring- Future date when the article should be reviewed again, as an ISO 8601 datetime.
statusinteger- Article status: 1 = Draft, 2 = Published.one of
12 tagsarray- Tags for the article. Example: ["vpn"].
titlestring- Title of the article. Example: How to reset your VPN password.
freshservice_ticket_child_createCreate a child ticket under an existing Freshservice ticket.WriteCreate Child Ticket
Create a child ticket under an existing Freshservice ticket. Returns the created child ticket object. Use this to split work under a parent incident. Use freshservice_ticket_create for a standalone ticket. A child ticket cannot have its own children, and the parent cannot be deleted or spam. Identify the requester with email, requester_id or phone.
Inputs
parent_ticket_idintegerrequired- Numeric ID of the parent ticket.
priorityintegerrequired- Ticket priority: 1 = Low, 2 = Medium, 3 = High, 4 = Urgent.one of
1234 statusintegerrequired- Ticket status: 2 = Open, 3 = Pending, 4 = Resolved, 5 = Closed.one of
2345 cc_emailsarray- Email addresses to CC. Example: ["ram@example.com"].
descriptionstring- Description of the child ticket in HTML. Plain text also works.
emailstring- Email address of the requester; a new requester is created if none matches. Provide email, requester_id or phone.
group_idinteger- ID of the agent group to assign the child ticket to.
namestring- Name of the requester; required with a phone-only new requester.
phonestring- Phone number of the requester. If used without email for a new requester, also send name.
requester_idinteger- User ID of an existing requester, used instead of email.
responder_idinteger- User ID of the agent to assign the child ticket to.
subjectstring- Subject line of the child ticket.
workspace_idinteger- Workspace ID for the child ticket. Omit for the primary workspace.
freshservice_ticket_createCreate a new incident ticket in Freshservice.WriteCreate Ticket
Create a new incident ticket in Freshservice. Returns the created ticket object, including its new id. Use this to log an incident. Use freshservice_service_request_create to order an item from the service catalog, and freshservice_ticket_child_create to add a child ticket under an existing one. Identify the requester with email, requester_id or phone.
Inputs
descriptionstringrequired- Full description of the ticket in HTML. Plain text also works. Example: <div>VPN client fails with error 809 since this morning.</div>
priorityintegerrequired- Ticket priority: 1 = Low, 2 = Medium, 3 = High, 4 = Urgent.one of
1234 statusintegerrequired- Ticket status: 2 = Open, 3 = Pending, 4 = Resolved, 5 = Closed.one of
2345 subjectstringrequired- Subject line of the ticket. Example: Unable to connect to VPN.
assetsarray- Assets to associate with the ticket, each given by its display ID. Example: [{"display_id": 7}, {"display_id": 8}].
categorystring- Ticket category, matching one of the category values configured in Freshservice. Example: Hardware.
cc_emailsarray- Email addresses to copy on the ticket. Example: ["it-lead@example.com"].
custom_fieldsobject- Values for custom ticket fields, keyed by each field's internal name (snake_case, as returned by the matching list-fields tool). Example: {"custom_text": "Laptop model X1"}
department_idinteger- ID of the department the ticket belongs to. Get IDs from freshservice_departments_list.
due_bystring- Time the ticket is due to be resolved, as an ISO 8601 datetime. Example: 2026-11-01T17:00:00Z.
emailstring- Email address of the requester. If no requester exists with this email, Freshservice creates one. Provide email, requester_id or phone to identify the requester.
fr_due_bystring- Time the first response is due, as an ISO 8601 datetime. Must be earlier than due_by.
group_idinteger- ID of the agent group to assign the ticket to. Get group IDs from freshservice_agent_groups_list.
impactinteger- Impact of the ticket: 1 = Low, 2 = Medium, 3 = High.one of
123 item_categorystring- Ticket item category under the chosen sub-category. Example: Keyboard.
namestring- Name of the requester. Required when the requester is identified by phone only and does not exist yet.
phonestring- Phone number of the requester. If no requester has this number, Freshservice creates one; in that case also send name.
requested_for_idinteger- User ID of the person the request is raised on behalf of. On update this can only be changed for Service Request tickets.
requester_idinteger- User ID of an existing requester, used instead of email. Get IDs from freshservice_requesters_list or freshservice_requesters_filter.
responder_idinteger- User ID of the agent to assign the ticket to. Get agent IDs from freshservice_agents_list.
sourceinteger- Channel the ticket came from: 1 = Email, 2 = Portal, 3 = Phone, 4 = Chat, 5 = Feedback widget, 6 = Yammer, 7 = AWS Cloudwatch, 8 = Pagerduty, 9 = Walkup, 10 = Slack.one of
12345678910 sub_categorystring- Ticket sub-category under the chosen category. Example: Peripherals.
tagsarray- Tags to attach to the ticket. On update, send the full list you want to keep, because it replaces the existing tags. Example: ["vpn", "remote"].
urgencyinteger- Urgency of the ticket: 1 = Low, 2 = Medium, 3 = High.one of
123 workspace_idinteger- ID of the workspace the ticket belongs to. Omit to use the primary workspace. Applies only to accounts that use workspaces; it cannot be changed later with an update.
freshservice_ticket_note_createAdd a note to a Freshservice ticket.WriteAdd Note to Ticket
Add a note to a Freshservice ticket. Notes are private by default. Returns the created conversation object. Use this for internal updates between agents; set private to false for a public note. Use freshservice_ticket_reply_create to email the requester.
Inputs
bodystringrequired- Content of the note in HTML. Plain text also works. Example: <div>Escalated to the network team.</div>
ticket_idintegerrequired- Numeric ID of the ticket to add the note to.
incomingboolean- Set true to show the note as coming from outside Freshservice rather than from the web portal. Defaults to false.
notify_emailsarray- Email addresses of agents or users to notify about this note. Example: ["oncall@example.com"].
privateboolean- Whether the note is private (visible to agents only). Freshservice defaults to true.
user_idinteger- User ID of the agent adding the note. Defaults to the user who owns the API key.
freshservice_ticket_reply_createSend a public reply on a Freshservice ticket; the requester receives it by email.WriteReply to Ticket
Send a public reply on a Freshservice ticket; the requester receives it by email. Returns the created conversation object. Use this to respond to the requester. Use freshservice_ticket_note_create for internal or private notes.
Inputs
bodystringrequired- Content of the reply in HTML. Plain text also works. Example: <div>We are working on this issue and will update you within the hour.</div>
ticket_idintegerrequired- Numeric ID of the ticket to reply to.
bcc_emailsarray- Email addresses to BCC on the outgoing reply. Example: ["audit@example.com"].
cc_emailsarray- Email addresses to CC on the outgoing reply. Example: ["manager@example.com"].
from_emailstring- Email address the reply is sent from. Defaults to the global support email.
user_idinteger- User ID of the agent sending the reply. Defaults to the user who owns the API key.
freshservice_ticket_task_createCreate a task on a Freshservice ticket and optionally assign it to an agent or group.WriteCreate Ticket Task
Create a task on a Freshservice ticket and optionally assign it to an agent or group. Returns the created task object with its id. Use this to break ticket work into tracked steps. Use freshservice_ticket_task_update to change or complete a task.
Inputs
ticket_idintegerrequired- Numeric ID of the ticket to add the task to.
titlestringrequired- Title of the task. Example: Replace failing disk on ES3.
agent_idinteger- User ID of the agent the task is assigned to. Get agent IDs from freshservice_agents_list.
descriptionstring- Longer description of the work to be done in the task.
due_datestring- Due date of the task as an ISO 8601 datetime, for example 2026-11-01T17:00:00Z.
group_idinteger- ID of the agent group the task is assigned to. Get group IDs from freshservice_agent_groups_list.
notify_beforeinteger- How many seconds before the due date Freshservice sends a reminder. 0 sends no early reminder; 3600 reminds one hour before.
statusinteger- Status of the task: 1 = Open, 2 = In Progress, 3 = Completed.one of
123 workspace_idinteger- ID of the workspace the task belongs to. Omit to use the workspace of the parent ticket. Applies only to accounts that use workspaces.
freshservice_ticket_task_updateUpdate a task on a Freshservice ticket, for example to change its status or assignee.WriteUpdate Ticket Task
Update a task on a Freshservice ticket, for example to change its status or assignee. Returns the updated task object. Use this to progress or complete a ticket task (status 3 = Completed).
- Idempotent
Inputs
task_idintegerrequired- Numeric ID of the task to update.
ticket_idintegerrequired- Numeric ID of the ticket.
agent_idinteger- User ID of the agent the task is assigned to. Get agent IDs from freshservice_agents_list.
descriptionstring- Longer description of the work to be done in the task.
due_datestring- Due date of the task as an ISO 8601 datetime, for example 2026-11-01T17:00:00Z.
group_idinteger- ID of the agent group the task is assigned to. Get group IDs from freshservice_agent_groups_list.
notify_beforeinteger- How many seconds before the due date Freshservice sends a reminder. 0 sends no early reminder; 3600 reminds one hour before.
statusinteger- Status of the task: 1 = Open, 2 = In Progress, 3 = Completed, 4 = Blocked.one of
1234 titlestring- Title of the task. Example: Replace failing disk on ES3.
freshservice_ticket_time_entry_createLog time spent on a Freshservice ticket, or start a timer.WriteCreate Ticket Time Entry
Log time spent on a Freshservice ticket, or start a timer. Returns the created time entry with its id, time spent and billable flag. Use this to record agent effort. Send time_spent for completed work, or timer_running=true (without time_spent) to start a timer.
Inputs
agent_idintegerrequired- User ID of the agent the time entry belongs to.
ticket_idintegerrequired- Numeric ID of the ticket.
billableboolean- Whether the time is billable. Defaults to true.
executed_atstring- When the work was done, as an ISO 8601 datetime no later than now. Defaults to the creation time.
notestring- Description of the work done.
task_idinteger- ID of a task on this ticket, assigned to the same agent, to attach the time to.
time_spentstring- Time spent in hh:mm format, for example 01:30. Required unless timer_running is true; cannot be set while a timer runs.
timer_runningboolean- Set true to start a running timer instead of logging fixed time. Only one timer can run per agent. Defaults to false.
freshservice_ticket_time_entry_updateUpdate a time entry on a Freshservice ticket, for example to change its note or stop a timer.WriteUpdate Ticket Time Entry
Update a time entry on a Freshservice ticket, for example to change its note or stop a timer. Returns the updated time entry. Use this to correct logged time. Set timer_running to false to stop a running timer.
- Idempotent
Inputs
ticket_idintegerrequired- Numeric ID of the ticket.
time_entry_idintegerrequired- Numeric ID of the time entry to update.
agent_idinteger- User ID of the agent the time entry belongs to.
billableboolean- Whether the time is billable.
executed_atstring- When the work was done, as an ISO 8601 datetime no later than now.
notestring- Description of the work done.
task_idinteger- ID of a task on this ticket to attach the time to.
time_spentstring- Time spent in hh:mm format. Cannot be set while the timer is running.
timer_runningboolean- Set false to stop a running timer, or true to restart it.
freshservice_ticket_updateUpdate fields on an existing Freshservice ticket, such as status, priority, assignee or tags.WriteUpdate Ticket
Update fields on an existing Freshservice ticket, such as status, priority, assignee or tags. Returns the updated ticket object. Use this to change ticket properties. Use freshservice_ticket_reply_create to reply to the requester and freshservice_ticket_note_create to add a note.
- Idempotent
Inputs
ticket_idintegerrequired- Numeric ID of the ticket to update.
assetsarray- Assets to associate with the ticket, each given by its display ID. Example: [{"display_id": 7}, {"display_id": 8}].
categorystring- Ticket category, matching one of the category values configured in Freshservice. Example: Hardware.
cc_emailsarray- Email addresses to copy on the ticket. Example: ["it-lead@example.com"].
custom_fieldsobject- Values for custom ticket fields, keyed by each field's internal name (snake_case, as returned by the matching list-fields tool). Example: {"custom_text": "Laptop model X1"}
department_idinteger- ID of the department the ticket belongs to. Get IDs from freshservice_departments_list.
descriptionstring- Full description of the ticket in HTML. Plain text also works. Example: <div>VPN client fails with error 809 since this morning.</div>
due_bystring- Time the ticket is due to be resolved, as an ISO 8601 datetime. Example: 2026-11-01T17:00:00Z.
fr_due_bystring- Time the first response is due, as an ISO 8601 datetime. Must be earlier than due_by.
group_idinteger- ID of the agent group to assign the ticket to. Get group IDs from freshservice_agent_groups_list.
impactinteger- Impact of the ticket: 1 = Low, 2 = Medium, 3 = High.one of
123 item_categorystring- Ticket item category under the chosen sub-category. Example: Keyboard.
priorityinteger- Ticket priority: 1 = Low, 2 = Medium, 3 = High, 4 = Urgent.one of
1234 requested_for_idinteger- User ID of the person the request is raised on behalf of. On update this can only be changed for Service Request tickets.
requester_idinteger- User ID of an existing requester, used instead of email. Get IDs from freshservice_requesters_list or freshservice_requesters_filter.
responder_idinteger- User ID of the agent to assign the ticket to. Get agent IDs from freshservice_agents_list.
sourceinteger- Channel the ticket came from: 1 = Email, 2 = Portal, 3 = Phone, 4 = Chat, 5 = Feedback widget, 6 = Yammer, 7 = AWS Cloudwatch, 8 = Pagerduty, 9 = Walkup, 10 = Slack.one of
12345678910 statusinteger- Ticket status: 2 = Open, 3 = Pending, 4 = Resolved, 5 = Closed.one of
2345 sub_categorystring- Ticket sub-category under the chosen category. Example: Peripherals.
subjectstring- Subject line of the ticket. Example: Unable to connect to VPN.
tagsarray- Tags to attach to the ticket. On update, send the full list you want to keep, because it replaces the existing tags. Example: ["vpn", "remote"].
urgencyinteger- Urgency of the ticket: 1 = Low, 2 = Medium, 3 = High.one of
123
No tools match.
