Skip to main content
Freshservice logo
  • Category: customer support
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 12
  • Triggers: 0
  • Slug: FRESHSERVICE
  • Version: 20261101_00

Tools

Slug: FRESHSERVICE_BULK_UPDATE_TICKETSUpdates 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

array
required
List of Freshservice ticket IDs to update
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FRESHSERVICE_CREATE_SERVICE_REQUESTCreate 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

string
Email address of the requester. If not provided, the authenticated user is used.
integer
Quantity of the catalog item to request. Defaults to 1 if not specified.
object
Custom field values for the service item form. Keys are the custom field names.
integer
required
Display ID of the catalog item to request. Find it in Admin > Service Catalog > Item URL.
integer
Display ID of the parent ticket when creating as a child service request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FRESHSERVICE_CREATE_TICKETCreate a new Freshservice ticket to log an incident.

Input Parameters

string
Name of the requester (creates new contact if not found)
string ("Incident" | "Service Request")
Enum for Freshservice ticket type values.
string
Email address of the requester. Provide either requester_id or email
string ("low" | "medium" | "high")
Enum for Freshservice ticket impact values.
string ("email" | "portal" | "phone" | "chat" | "twitter" | "facebook")
Enum for Freshservice ticket source values.
string ("open" | "pending" | "resolved" | "closed")
required
Status of the ticket.
string
required
Subject of the ticket
string ("low" | "medium" | "high" | "critical")
Enum for Freshservice ticket urgency values.
string ("low" | "medium" | "high" | "urgent")
required
Priority of the ticket.
array
CC email addresses for outbound email tickets
string
required
HTML description of the ticket
integer
User ID of the requester. Provide either requester_id or email
integer
Email config ID for outbound email ticket creation

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FRESHSERVICE_DELETE_RELEASEDeletes a release from Freshservice. Deleted releases can be restored.

Input Parameters

integer
required
The unique ID of the release to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FRESHSERVICE_DELETE_SOLUTION_ARTICLEDeletes 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

integer
required
ID of the solution article to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FRESHSERVICE_DELETE_SOLUTION_CATEGORYDeletes a Freshservice solution category, moving it and its associated folders and articles to Trash. They can be restored.

Input Parameters

integer
required
The unique ID of the solution category to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FRESHSERVICE_GET_AGENTRetrieve one Freshservice support agent profile by its numeric user ID.

Input Parameters

integer
required
Unique ID of the agent to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FRESHSERVICE_GET_PROBLEM_FORM_FIELDS_BY_WORKSPACELists Freshservice problem form field definitions for a specified workspace. If no workspace is specified, it returns global and primary workspace fields.

Input Parameters

integer
ID of the workspace to list problem form fields for. If omitted, returns global and primary workspace fields.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FRESHSERVICE_GET_RELEASE_FORM_FIELDSLists 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

integer
Filter fields for a specific workspace. By default only global fields and primary workspace fields are returned in Employee Support Mode.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FRESHSERVICE_GET_REQUESTERRetrieve one Freshservice requester profile by its numeric user ID.

Input Parameters

integer
required
Unique ID of the requester to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FRESHSERVICE_GET_SERVICE_CATALOG_ITEMRetrieve a service catalog item’s details and request form by display ID.

Input Parameters

integer
required
Display ID of the service catalog item to retrieve
integer
Workspace ID used to resolve the catalog item

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FRESHSERVICE_GET_TICKETRetrieve a specific Freshservice ticket by ID, including its status, priority, requester ID, and other supported attributes.

Input Parameters

string
Comma-separated list of additional fields to include (e.g., ‘requester’, ‘stats’, ‘description’, ‘conversations’, ‘assets’). Each include consumes additional credits.
integer
required
The unique ID or display_id of the ticket to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FRESHSERVICE_LIST_AGENTSReturn Freshservice support agents page by page.

Input Parameters

integer
Page number to return (1-indexed; must be at least 1)
string
Return the agent with this exact email address
string ("fulltime" | "occasional")
Return only full-time or occasional agents
boolean
Return only active or inactive agents
integer
Number of agents to return per page (between 1 and 100)
string
Return agents with this work phone number
string
Return agents with this mobile phone number

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FRESHSERVICE_LIST_LOCATIONSLists 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

integer
Page number for pagination (1-indexed; must be >=1)
integer
Number of locations per page (must be between 1 and 100)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FRESHSERVICE_LIST_PROJECT_TASKSReturn a page of tasks belonging to one Freshservice project.

Input Parameters

integer
Page number for pagination (1-indexed)
string ("open" | "unresolved")
Return only open or unresolved tasks; omit to return all tasks
integer
Number of project tasks to return per page (1-100)
integer
required
Unique ID of the project whose tasks to list

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FRESHSERVICE_LIST_SERVICE_CATALOG_ITEMSRequests 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

integer
Page number for pagination (1-indexed; must be >=1)
integer
Number of items per page (must be between 1 and 100)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FRESHSERVICE_LIST_TICKET_APPROVALSReturn approvals and their current participants for a service request.

Input Parameters

integer
required
Unique ID or display ID of the service-request ticket

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FRESHSERVICE_LIST_TICKET_CONVERSATIONSReturn a page of replies and notes on one Freshservice ticket.

Input Parameters

integer
Page number for pagination (1-indexed)
integer
Number of conversations to return per page (1-100)
integer
required
Unique ID of the ticket whose replies and notes to list

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FRESHSERVICE_LIST_TICKETSList 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

integer
Page number for pagination (1-indexed; must be >=1)
string ("all_tickets" | "deleted" | "spam" | "watching")
Filter tickets by predefined criteria.
string
Comma-separated list of additional fields to include (e.g., ‘requester’, ‘stats’, ‘description’, ‘conversations’, ‘assets’). Each include consumes additional credits.
string
Field to sort by (e.g., ‘created_at’, ‘updated_at’, ‘status’, ‘priority’)
integer
Number of tickets per page (must be between 1 and 100, default 30)
string ("asc" | "desc")
Sort order: ‘asc’ for ascending or ‘desc’ for descending.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FRESHSERVICE_SEARCH_TICKETSSearch Freshservice tickets using the provider’s filter expression syntax.

Input Parameters

integer
Page number for pagination (1-indexed)
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.
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.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not