Manage tickets and requesters, read agents and groups, and deactivate agents.
Explore 76 workflow actions for Freshservice, including account permissions and operation limits.
31 read actions45 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Add private note
Write
Add an internal note to a Freshservice ticket.
Permissions and limits
Account permissions
freshservice.conversations.create
A repeated request may repeat the external action. Review the previous result before retrying a write.
Add requester group member
Write
Add one requester to a manual Freshservice group.
Permissions and limits
Account permissions
freshservice.requesters.edit
Operation limits
Only manual groups accept members, one requester per call. Freshservice requires the requester to belong to the group's client workspace unless the group is global. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create agent
Write
Create a Freshservice agent with an email address and explicit role assignments.
Permissions and limits
Account permissions
freshservice.agents.manage
Operation limits
Freshservice MSP client assignment is not supported by this action. The roles array grants permissions and must be reviewed before execution. Restricted-group membership is not configured here. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create agent group
Write
Create a Freshservice agent group with optional members and observers.
Permissions and limits
Account permissions
freshservice.agentgroups.manage
Operation limits
Freshservice creates groups in its default workspace unless workspace_id is supplied. This action does not configure restricted-group approvals. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create announcement
Write
Publish an announcement to everyone or agents in one Freshservice workspace.
Permissions and limits
Account permissions
freshservice.announcements.create
Operation limits
This action supports everyone or agents-only visibility. It does not send email or configure group-specific visibility. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create asset type
Write
Create a named Freshservice asset type.
Permissions and limits
Account permissions
freshservice.asset_types.create
Operation limits
The optional parent ID must name an existing Freshservice asset type. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create change
Write
Create a change request with requester, risk and impact.
Permissions and limits
Account permissions
freshservice.changes.create
Operation limits
Freshservice uses its primary workspace unless workspace_id is supplied. This action does not upload attachments. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create department
Write
Create a Freshservice department or MSP company.
Permissions and limits
Account permissions
freshservice.departments.manage
Operation limits
Freshservice creates in workspace 2 by default. MSP accounts should supply the intended client workspace. Global workspace 1 is not allowed. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create location
Write
Create an office or other Freshservice location.
Permissions and limits
Account permissions
freshservice.locations.create
Operation limits
Freshservice MSP accounts require workspace_id for the intended client. Omitting it uses the provider's default client. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create problem
Write
Create a problem with an owner, due time and severity.
Permissions and limits
Account permissions
freshservice.problems.create
Operation limits
Freshservice uses the primary workspace unless workspace_id is supplied. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create product
Write
Create a Freshservice asset product for an existing asset type.
Permissions and limits
Account permissions
freshservice.products.create
Operation limits
An existing Freshservice asset type ID is required. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create release
Write
Create a Freshservice release with type, priority and status.
Permissions and limits
Account permissions
freshservice.releases.create
Operation limits
Freshservice's documented create response is a bare object, unlike the release envelope used for reads and updates. This action requires a returned ID before reporting success. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create requester
Write
Create a requester with a name and primary email address.
Permissions and limits
Account permissions
freshservice.requesters.create
Operation limits
Freshservice MSP accounts create requesters in the primary client. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create requester group
Write
Create a manual Freshservice requester group.
Permissions and limits
Account permissions
freshservice.requesters.edit
Operation limits
Freshservice creates only manual requester groups through this API. In MSP accounts, supply workspace_id for the intended client; omitting it uses client workspace 2. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create software
Write
Create a Freshservice software application.
Permissions and limits
Account permissions
freshservice.assets.manage
Operation limits
Freshservice defaults to desktop software and the primary workspace unless supplied. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create ticket
Write
Create a Freshservice ticket for a requester email address.
Permissions and limits
Account permissions
freshservice.tickets.create
A repeated request may repeat the external action. Review the previous result before retrying a write.
Deactivate agent
Write
Deactivate a Freshservice agent account.
Permissions and limits
Account permissions
freshservice.agents.manage
Operation limits
Freshservice deactivates the agent rather than permanently deleting it. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Deactivate requester
Write
Deactivate a requester account without permanently forgetting its data.
Permissions and limits
Account permissions
freshservice.requesters.delete
Operation limits
Freshservice calls this deactivation, not permanent deletion. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete agent group
Write
Disband a Freshservice agent group without deleting its agents.
Permissions and limits
Account permissions
freshservice.agentgroups.manage
Operation limits
Deleted groups cannot be restored. Freshservice may rescope an agent's role when this was its only group. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete announcement
Write
Delete a Freshservice announcement by ID.
Permissions and limits
Account permissions
freshservice.announcements.delete
Operation limits
Freshservice documents HTTP 200 as the deletion confirmation. The request is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete asset type
Write
Delete a Freshservice asset type by ID.
Permissions and limits
Account permissions
freshservice.asset_types.delete
Operation limits
Freshservice documents HTTP 204 as deletion confirmation. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete change
Write
Delete a Freshservice change request by ID.
Permissions and limits
Account permissions
freshservice.changes.delete
Operation limits
Freshservice documents HTTP 204 as deletion confirmation and offers a separate restore API. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete department
Write
Delete a Freshservice department or MSP company by ID.
Permissions and limits
Account permissions
freshservice.departments.delete
Operation limits
Freshservice documents HTTP 204 as deletion confirmation. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete location
Write
Delete a Freshservice location by ID.
Permissions and limits
Account permissions
freshservice.locations.delete
Operation limits
Freshservice documents HTTP 204 as confirmation. The request is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete problem
Write
Delete a Freshservice problem by ID.
Permissions and limits
Account permissions
freshservice.problems.delete
Operation limits
Freshservice documents HTTP 200 as deletion confirmation. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete product
Write
Delete a Freshservice asset product by ID.
Permissions and limits
Account permissions
freshservice.products.delete
Operation limits
Freshservice documents HTTP 204 as deletion confirmation. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete release
Write
Delete a Freshservice release by ID.
Permissions and limits
Account permissions
freshservice.releases.delete
Operation limits
Freshservice documents HTTP 200 as deletion confirmation. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete requester group
Write
Disband a Freshservice requester group without deleting its members.
Permissions and limits
Account permissions
freshservice.requesters.delete
Operation limits
Deleted groups cannot be restored, but their requesters remain. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete software
Write
Delete a Freshservice software application by ID.
Permissions and limits
Account permissions
freshservice.assets.delete
Operation limits
Freshservice documents HTTP 204 as deletion confirmation. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete ticket
Write
Move a Freshservice ticket to deleted tickets, where it can be restored.
Permissions and limits
Account permissions
freshservice.tickets.delete
Operation limits
Deleting a parent service request can also delete its child tickets. The request is sent once; an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Get agent
Read
Read a Freshservice agent by ID.
Permissions and limits
Account permissions
freshservice.agents.manage
Get agent group
Read
Read a Freshservice agent group by ID.
Permissions and limits
Account permissions
freshservice.agentgroups.manage
Get agent role
Read
Read a Freshservice role by ID.
Permissions and limits
Account permissions
freshservice.agents.roles.view
Get announcement
Read
Read a Freshservice announcement by ID.
Permissions and limits
Account permissions
freshservice.announcements.view
Get asset type
Read
Read one Freshservice asset type by ID.
Permissions and limits
Account permissions
freshservice.asset_types.view
Get change
Read
Read a Freshservice change request by ID.
Permissions and limits
Account permissions
freshservice.changes.view
Get department
Read
Read a Freshservice department or MSP company by ID.
Permissions and limits
Account permissions
freshservice.departments.view
Get location
Read
Read a Freshservice location by ID.
Permissions and limits
Account permissions
freshservice.locations.view
Operation limits
Freshservice documents both location and locations object envelopes for this response. Listing uses a locations array.
Get problem
Read
Read a Freshservice problem by ID.
Permissions and limits
Account permissions
freshservice.problems.view
Get product
Read
Read a Freshservice asset product by ID.
Permissions and limits
Account permissions
freshservice.products.view
Get release
Read
Read a Freshservice release by ID.
Permissions and limits
Account permissions
freshservice.releases.view
Get requester
Read
Read one requester by ID.
Permissions and limits
Account permissions
freshservice.requesters.view
Get requester group
Read
Read one requester group by ID.
Permissions and limits
Account permissions
freshservice.requesters.view
Get software
Read
Read a Freshservice software application by ID.
Permissions and limits
Account permissions
freshservice.assets.view
Get ticket
Read
Read a ticket by its numeric ID.
Permissions and limits
Account permissions
freshservice.tickets.view
List agent groups
Read
Read one page of agent groups in a Freshservice workspace.
Permissions and limits
Account permissions
freshservice.agentgroups.manage
Operation limits
Freshservice requires workspace_id to list groups from a non-default workspace. Without it, the API does not return groups from every workspace.
Pagination: page. Check the result for additional pages; a single action may not return every record.
List agent roles
Read
Read one page of roles available to Freshservice agents.
Permissions and limits
Account permissions
freshservice.agents.roles.view
Operation limits
Only agents permitted to view roles can use this operation.
Pagination: page. Check the result for additional pages; a single action may not return every record.
List agents
Read
Read one page of Freshservice agents.
Permissions and limits
Account permissions
freshservice.agents.manage
Operation limits
This action reads one page. The connected API key must have agent management permission.
Pagination: page. Check the result for additional pages; a single action may not return every record.
List announcements
Read
Read one page of Freshservice announcements.
Permissions and limits
Account permissions
freshservice.announcements.view
Operation limits
Omitting workspace_id reads only the primary Freshservice workspace. Use 0 to request announcements across its workspaces.
Pagination: page. Check the result for additional pages; a single action may not return every record.
List asset types
Read
Read one page of Freshservice asset types.
Permissions and limits
Account permissions
freshservice.assets.view
Operation limits
Freshservice documents asset type APIs for its IT service management offering. This action reads one page.
Pagination: page. Check the result for additional pages; a single action may not return every record.
List changes
Read
Read one page of Freshservice change requests.
Permissions and limits
Account permissions
freshservice.changes.view
Operation limits
Freshservice returns only its primary workspace by default. Cross-workspace responses include only global fields.
Pagination: page. Check the result for additional pages; a single action may not return every record.
List departments
Read
Read one page of Freshservice departments or MSP companies.
Permissions and limits
Account permissions
freshservice.departments.view
Operation limits
Freshservice defaults to workspace 2. MSP accounts scope departments to a client workspace; this does not list all clients at once.
Pagination: page. Check the result for additional pages; a single action may not return every record.
List locations
Read
Read one page of Freshservice locations.
Permissions and limits
Account permissions
freshservice.locations.view
Operation limits
Without workspace_id, Freshservice returns the default workspace's locations. For another workspace, provide its Freshservice workspace ID greater than 1.
Pagination: page. Check the result for additional pages; a single action may not return every record.
List problems
Read
Read one page of Freshservice problems.
Permissions and limits
Account permissions
freshservice.problems.view
Operation limits
Freshservice returns only the primary workspace by default. Use workspace_id 0 for accessible cross-workspace problems, which include only global fields.
Pagination: page. Check the result for additional pages; a single action may not return every record.
List products
Read
Read one page of Freshservice asset products.
Permissions and limits
Account permissions
freshservice.products.view
Operation limits
Freshservice documents product APIs for its IT service management offering. This action reads one page.
Pagination: page. Check the result for additional pages; a single action may not return every record.
List releases
Read
Read one page of Freshservice releases.
Permissions and limits
Account permissions
freshservice.releases.view
Operation limits
Freshservice returns only its primary workspace by default. Cross-workspace responses include only global fields.
Pagination: page. Check the result for additional pages; a single action may not return every record.
List requester group members
Read
Read one page of requesters belonging to a Freshservice group.
Permissions and limits
Account permissions
freshservice.requesters.edit
Operation limits
Returns one page. Use page to read more group members.
Pagination: page. Check the result for additional pages; a single action may not return every record.
List requester groups
Read
Read one page of requester groups in a Freshservice client workspace.
Permissions and limits
Account permissions
freshservice.requesters.view
Operation limits
Without workspace_id, Freshservice returns client workspace 2. Use workspace_id 1 for global contact groups.
Pagination: page. Check the result for additional pages; a single action may not return every record.
List requesters
Read
Read one page of requesters in the connected Freshservice account.
Permissions and limits
Account permissions
freshservice.requesters.view
Operation limits
Freshservice MSP accounts return the primary client by default. This action does not select other Freshservice clients.
Pagination: page. Check the result for additional pages; a single action may not return every record.
List software
Read
Read Freshservice software applications visible in a workspace.
Permissions and limits
Account permissions
freshservice.assets.view
Operation limits
Freshservice uses a singular application key even for a list. Omitting workspace_id selects the primary workspace.
List tickets
Read
Read one page of tickets visible to this Freshservice account.
Permissions and limits
Account permissions
freshservice.tickets.view
Operation limits
Returns one page. Use page to request the next page.
Pagination: page. Check the result for additional pages; a single action may not return every record.
Remove requester group member
Write
Remove one requester from a manual Freshservice group.
Permissions and limits
Account permissions
freshservice.requesters.edit
Operation limits
Only manual groups support member removal. The requester account is not deleted. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update agent
Write
Edit a Freshservice agent profile with an explicit department-ticket visibility choice.
Permissions and limits
Account permissions
freshservice.agents.manage
Operation limits
This action targets standard Freshservice accounts. Freshservice MSP does not support the required department-ticket visibility field. If roles are sent, provide the complete intended role set. Group memberships are omitted because update requests must preserve pending approvals. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update agent group
Write
Change an agent group's name and escalation settings without touching membership approvals.
Permissions and limits
Account permissions
freshservice.agentgroups.manage
Operation limits
Freshservice requires the group name on update. Membership, leaders and restriction settings are not exposed here because an incomplete replacement can withdraw pending approvals or auto approve them. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update announcement
Write
Replace an announcement's title, content and audience in Freshservice.
Permissions and limits
Account permissions
freshservice.announcements.edit
Operation limits
Supply the complete title, HTML body and audience. This action supports everyone or agents-only visibility and does not preserve group-specific audiences. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update asset type
Write
Update a Freshservice asset type's name or description.
Permissions and limits
Account permissions
freshservice.asset_types.edit
Operation limits
Visibility is omitted because Freshservice only permits changing it for default asset types. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update change
Write
Edit a Freshservice change request.
Permissions and limits
Account permissions
freshservice.changes.edit
Operation limits
Freshservice does not permit changing workspace_id through this endpoint. This action does not upload attachments. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update department
Write
Update a Freshservice department or MSP company.
Permissions and limits
Account permissions
freshservice.departments.manage
Operation limits
Freshservice requires the department name on update. The workspace cannot be changed here. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update location
Write
Edit an existing Freshservice location's name or details.
Permissions and limits
Account permissions
freshservice.locations.edit
Operation limits
Supply the location name with each update. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update problem
Write
Edit the classification, assignment or due time of a problem.
Permissions and limits
Account permissions
freshservice.problems.edit
Operation limits
Freshservice does not permit changing workspace_id through this endpoint. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update product
Write
Update the name, asset type or details of a Freshservice product.
Permissions and limits
Account permissions
freshservice.products.update
Operation limits
Supply both the product name and asset type ID with each update. The vendor docs label this endpoint PUT, although one sample command says POST. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update release
Write
Edit a Freshservice release.
Permissions and limits
Account permissions
freshservice.releases.edit
Operation limits
Freshservice does not permit changing workspace_id through this endpoint. This action does not upload attachments. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update requester
Write
Edit a requester's basic profile fields.
Permissions and limits
Account permissions
freshservice.requesters.edit
Operation limits
Set department ticket visibility explicitly. Freshservice resets it to false unless the request includes true.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update requester group
Write
Update the name or description of a manual requester group.
Permissions and limits
Account permissions
freshservice.requesters.edit
Operation limits
Only manual groups can be updated. Supply the group's name with each update. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update software
Write
Edit a Freshservice software application.
Permissions and limits
Account permissions
freshservice.assets.manage
Operation limits
Freshservice does not permit changing workspace_id through this endpoint. The write is sent once and an uncertain result is not retried automatically.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update ticket
Write
Edit a ticket's subject, description, status or priority.
Permissions and limits
Account permissions
freshservice.tickets.edit
A repeated request may repeat the external action. Review the previous result before retrying a write.
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in Freshservice. A saved workflow is not a completed provider action.