> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Freshservice

> Freshservice is a cloud-based IT service management (ITSM) solution with incident management, asset management, and IT service automation capabilities

![Freshservice logo](https://mintcdn.com/composio-preview/GL28i3tBlbEbBd-f/images/toolkits/freshservice.svg?fit=max\&auto=format\&n=GL28i3tBlbEbBd-f\&q=85\&s=8dbfda0e5e34577b1eb4e40655927622)

* **Category:** customer support
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 12
* **Triggers:** 0
* **Slug:** `FRESHSERVICE`
* **Version:** 20261101\_00

## Tools

> [accordion] Bulk Update Tickets
>
> **Slug:** `FRESHSERVICE_BULK_UPDATE_TICKETS`
>
> Updates the same supplied fields on multiple Freshservice tickets identified by ID, using sequential requests. Returns the IDs reported as updated and per-ticket failure details, so results can be reviewed individually.
>
> #### Input Parameters
>
> **ids** `array` *required*
>
> List of Freshservice ticket IDs to update
>
> **update\_fields** `object` *required*
>
> Dictionary of ticket fields to update. Allowed keys include 'subject', 'description', 'status', 'priority', 'responder\_id', 'group\_id', 'type', 'tags', 'custom\_fields', etc.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Service Request
>
> **Slug:** `FRESHSERVICE_CREATE_SERVICE_REQUEST`
>
> Create a service request for a catalog item in Freshservice using the v2 API. The catalog item display\_id can be found in Admin > Service Catalog by clicking on an item and checking the URL (e.g., /service\_catalog/items/1 means display\_id=1).
>
> #### Input Parameters
>
> **email** `string`
>
> Email address of the requester. If not provided, the authenticated user is used.
>
> **quantity** `integer`
>
> Quantity of the catalog item to request. Defaults to 1 if not specified.
>
> **custom\_fields** `object`
>
> Custom field values for the service item form. Keys are the custom field names.
>
> **item\_display\_id** `integer` *required*
>
> Display ID of the catalog item to request. Find it in Admin > Service Catalog > Item URL.
>
> **parent\_ticket\_id** `integer`
>
> Display ID of the parent ticket when creating as a child service request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Ticket
>
> **Slug:** `FRESHSERVICE_CREATE_TICKET`
>
> Create a new Freshservice ticket to log an incident.
>
> #### Input Parameters
>
> **name** `string`
>
> Name of the requester (creates new contact if not found)
>
> **type** `string ("Incident" | "Service Request")`
>
> Enum for Freshservice ticket type values.
>
> **email** `string`
>
> Email address of the requester. Provide either requester\_id or email
>
> **impact** `string ("low" | "medium" | "high")`
>
> Enum for Freshservice ticket impact values.
>
> **source** `string ("email" | "portal" | "phone" | "chat" | "twitter" | "facebook")`
>
> Enum for Freshservice ticket source values.
>
> **status** `string ("open" | "pending" | "resolved" | "closed")` *required*
>
> Status of the ticket.
>
> **subject** `string` *required*
>
> Subject of the ticket
>
> **urgency** `string ("low" | "medium" | "high" | "critical")`
>
> Enum for Freshservice ticket urgency values.
>
> **priority** `string ("low" | "medium" | "high" | "urgent")` *required*
>
> Priority of the ticket.
>
> **cc\_emails** `array`
>
> CC email addresses for outbound email tickets
>
> **description** `string` *required*
>
> HTML description of the ticket
>
> **requester\_id** `integer`
>
> User ID of the requester. Provide either requester\_id or email
>
> **email\_config\_id** `integer`
>
> Email config ID for outbound email ticket creation
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Release
>
> **Slug:** `FRESHSERVICE_DELETE_RELEASE`
>
> Deletes a release from Freshservice. Deleted releases can be restored.
>
> #### Input Parameters
>
> **release\_id** `integer` *required*
>
> The unique ID of the release to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Solution Article
>
> **Slug:** `FRESHSERVICE_DELETE_SOLUTION_ARTICLE`
>
> Deletes a Freshservice knowledge base solution article by ID, moving it to Trash where it can be restored. The tool also reports a 404 response as success.
>
> #### Input Parameters
>
> **article\_id** `integer` *required*
>
> ID of the solution article to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Solution Category
>
> **Slug:** `FRESHSERVICE_DELETE_SOLUTION_CATEGORY`
>
> Deletes a Freshservice solution category, moving it and its associated folders and articles to Trash. They can be restored.
>
> #### Input Parameters
>
> **category\_id** `integer` *required*
>
> The unique ID of the solution category to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Freshservice Agent
>
> **Slug:** `FRESHSERVICE_GET_AGENT`
>
> Retrieve one Freshservice support agent profile by its numeric user ID.
>
> #### Input Parameters
>
> **agent\_id** `integer` *required*
>
> Unique ID of the agent to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Problem Form Fields by Workspace
>
> **Slug:** `FRESHSERVICE_GET_PROBLEM_FORM_FIELDS_BY_WORKSPACE`
>
> Lists Freshservice problem form field definitions for a specified workspace. If no workspace is specified, it returns global and primary workspace fields.
>
> #### Input Parameters
>
> **workspace\_id** `integer`
>
> ID of the workspace to list problem form fields for. If omitted, returns global and primary workspace fields.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Release Form Fields
>
> **Slug:** `FRESHSERVICE_GET_RELEASE_FORM_FIELDS`
>
> Lists Freshservice release form field definitions for building or validating release forms. Optionally select a workspace; by default, accounts with workspaces receive global fields and fields from the primary workspace.
>
> #### Input Parameters
>
> **workspace\_id** `integer`
>
> Filter fields for a specific workspace. By default only global fields and primary workspace fields are returned in Employee Support Mode.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Freshservice Requester
>
> **Slug:** `FRESHSERVICE_GET_REQUESTER`
>
> Retrieve one Freshservice requester profile by its numeric user ID.
>
> #### Input Parameters
>
> **requester\_id** `integer` *required*
>
> Unique ID of the requester to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Service Catalog Item
>
> **Slug:** `FRESHSERVICE_GET_SERVICE_CATALOG_ITEM`
>
> Retrieve a service catalog item's details and request form by display ID.
>
> #### Input Parameters
>
> **display\_id** `integer` *required*
>
> Display ID of the service catalog item to retrieve
>
> **workspace\_id** `integer`
>
> Workspace ID used to resolve the catalog item
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Freshservice Ticket
>
> **Slug:** `FRESHSERVICE_GET_TICKET`
>
> Retrieve a specific Freshservice ticket by ID, including its status, priority, requester ID, and other supported attributes.
>
> #### Input Parameters
>
> **include** `string`
>
> Comma-separated list of additional fields to include (e.g., 'requester', 'stats', 'description', 'conversations', 'assets'). Each include consumes additional credits.
>
> **ticket\_id** `integer` *required*
>
> The unique ID or display\_id of the ticket to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Freshservice Agents
>
> **Slug:** `FRESHSERVICE_LIST_AGENTS`
>
> Return Freshservice support agents page by page.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to return (1-indexed; must be at least 1)
>
> **email** `string`
>
> Return the agent with this exact email address
>
> **state** `string ("fulltime" | "occasional")`
>
> Return only full-time or occasional agents
>
> **active** `boolean`
>
> Return only active or inactive agents
>
> **per\_page** `integer`
>
> Number of agents to return per page (between 1 and 100)
>
> **work\_phone\_number** `string`
>
> Return agents with this work phone number
>
> **mobile\_phone\_number** `string`
>
> Return agents with this mobile phone number
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Freshservice Locations
>
> **Slug:** `FRESHSERVICE_LIST_LOCATIONS`
>
> Lists a page of Freshservice locations, with a choice of page number and page size. An empty list can also be returned when location access or the fallback request fails, so it does not necessarily mean there are no locations.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (1-indexed; must be >=1)
>
> **per\_page** `integer`
>
> Number of locations per page (must be between 1 and 100)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Project Tasks
>
> **Slug:** `FRESHSERVICE_LIST_PROJECT_TASKS`
>
> Return a page of tasks belonging to one Freshservice project.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (1-indexed)
>
> **filter** `string ("open" | "unresolved")`
>
> Return only open or unresolved tasks; omit to return all tasks
>
> **per\_page** `integer`
>
> Number of project tasks to return per page (1-100)
>
> **project\_id** `integer` *required*
>
> Unique ID of the project whose tasks to list
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Service Catalog Items
>
> **Slug:** `FRESHSERVICE_LIST_SERVICE_CATALOG_ITEMS`
>
> Requests a page of Freshservice service catalog items to help identify items and their display IDs for service requests. Supports page and page-size selection; Freshservice documents a maximum of 30 items per page. A 404 or 500 response is returned as an empty list.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (1-indexed; must be >=1)
>
> **per\_page** `integer`
>
> Number of items per page (must be between 1 and 100)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Ticket Approvals
>
> **Slug:** `FRESHSERVICE_LIST_TICKET_APPROVALS`
>
> Return approvals and their current participants for a service request.
>
> #### Input Parameters
>
> **ticket\_id** `integer` *required*
>
> Unique ID or display ID of the service-request ticket
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Ticket Conversations
>
> **Slug:** `FRESHSERVICE_LIST_TICKET_CONVERSATIONS`
>
> Return a page of replies and notes on one Freshservice ticket.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (1-indexed)
>
> **per\_page** `integer`
>
> Number of conversations to return per page (1-100)
>
> **ticket\_id** `integer` *required*
>
> Unique ID of the ticket whose replies and notes to list
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Freshservice Tickets
>
> **Slug:** `FRESHSERVICE_LIST_TICKETS`
>
> List Freshservice tickets with optional predefined filtering and pagination; on accounts with workspaces, results are limited to the primary workspace. By default, only tickets created within the past 30 days are returned; use updated\_since for older tickets, and note that a 404 response produces an empty list.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (1-indexed; must be >=1)
>
> **filter** `string ("all_tickets" | "deleted" | "spam" | "watching")`
>
> Filter tickets by predefined criteria.
>
> **include** `string`
>
> Comma-separated list of additional fields to include (e.g., 'requester', 'stats', 'description', 'conversations', 'assets'). Each include consumes additional credits.
>
> **order\_by** `string`
>
> Field to sort by (e.g., 'created\_at', 'updated\_at', 'status', 'priority')
>
> **per\_page** `integer`
>
> Number of tickets per page (must be between 1 and 100, default 30)
>
> **order\_type** `string ("asc" | "desc")`
>
> Sort order: 'asc' for ascending or 'desc' for descending.
>
> **updated\_since** `string`
>
> Timestamp to get tickets updated after this time (ISO 8601 format, e.g., '2026-01-01T00:00:00Z'). By default only tickets created within the past 30 days are returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Tickets
>
> **Slug:** `FRESHSERVICE_SEARCH_TICKETS`
>
> Search Freshservice tickets using the provider's filter expression syntax.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (1-indexed)
>
> **query** `string` *required*
>
> Freshservice ticket filter expression, including the provider-required surrounding double quotes (for example, "status:2 AND priority:3"). Field names, operators, and values follow Freshservice filter syntax.
>
> **per\_page** `integer`
>
> Requested page size. Freshservice does not document this parameter for ticket filtering and documents 30 tickets per page, so the value may be ignored; use page to scroll through results.
>
> **workspace\_id** `integer`
>
> ID of the workspace to search. When omitted, only tickets from the primary workspace are returned on accounts with workspaces. Use 0 to return tickets from all workspaces, with only global-level fields.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
