Skip to content
One platform. From customer conversation to completed work.Take a closer look
All connections
Support ยท CONNECTION

Freshservice + NodeHub

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.

Follow the workflow quickstart
EXPLORE YOUR STACK

More in Support.

Freshservice integration | NodeHub