Skip to main content

Freshservice Connector

Freshservice Freshservice is a cloud-based IT service management platform that streamlines IT operations, automates workflows, and improves service delivery for organizations. This component allows managing tickets, problems, agents, assets, and other IT service resources.

API Documentation​

This component was built using the Freshservice API v2.0.

Connections​

API Key​

Authenticate requests using an API key.

To authenticate with Freshservice, an API key is required.

Prerequisites​

  • A Freshservice account with API access enabled
  • The Freshservice domain name (e.g., if the Freshservice URL is https://example.freshservice.com, the domain is example)

Setup Steps​

  1. Log in to the Freshservice Support Portal
  2. Click the profile picture in the top-right corner of the portal
  3. Navigate to Profile Settings
  4. The API key is available below the Delegate Approvals section on the right side of the page
  5. Copy the API Key

For more details, refer to the Freshservice API key documentation.

Configure the Connection​

Create a connection of type API Key and configure the following fields:

  • Freshservice Domain: Enter only the domain name of the Freshservice account. For example, if the Freshservice URL is https://example.freshservice.com, enter example.
  • API Key: Enter the API key obtained from the profile settings page.
InputCommentsDefault
Freshservice DomainThe domain name of the Freshservice account. For example, if the Freshservice URL is https://example.freshservice.com, enter example.
API KeyThe Freshservice API key for authentication.

Triggers​

New and Updated Tickets​

Retrieves existing and ongoing tickets from Freshservice. Load history once, check for changes on a schedule, or both.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Show New RecordsWhen true, includes newly created tickets in the results.true
Show Updated RecordsWhen true, includes updated tickets in the results.true
Look-back DateThe date the initial sync starts from, in YYYY-MM-DD format. Cannot be a future date. Leave empty to sync the last 7 days. When set, the first recurrence seeds each ticket updated on or after this date once, applying the same record filters every later recurrence applies.

Actions​

Create Agent​

Creates a new agent in Freshservice.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
First NameThe given name of the agent.
Last NameThe family name of the agent.
EmailThe primary email address used to identify the agent.
RolesRoles of the agent. An array of hashes. See Freshservice API documentation for more information.
Contact InformationEmail, phone, and other contact channel details.
Work Phone NumberThe office or desk phone number for the agent.
Mobile Phone NumberThe cell phone number for the agent.
AddressThe physical or mailing address of the agent.
OccasionalWhen true, marks the agent as an occasional (part-time) agent rather than full-time.false
Job TitleThe role or position held by the agent.
Department IDsUnique IDs of the departments associated with the agent.
Can See All Tickets From Associated DepartmentsWhen true, allows the agent to view tickets filed by other members of associated departments.false
Extra BodyA JSON object of additional fields not covered by the standard inputs. See Freshservice API documentation for more information.

Create Asset (Deprecated)​

Creates a new asset in Freshservice. Applies to Freshservice accounts created before the March 31, 2026 IT Asset Management release.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
NameThe display name used to identify the asset.
Asset Type IDThe unique identifier for the asset type classification.
Additional FieldsAdditional optional fields: includes Asset Tag, Impact, Usage Type, and Description.
Asset TagThe tracking label assigned to the asset for inventory purposes.
ImpactThe business impact level if the asset becomes unavailable.
Usage TypeWhether the asset is permanently assigned or a loaner.
DescriptionA detailed summary of the asset specifications or purpose.
Location IDThe unique identifier for the location where the asset is assigned.
Agent IDThe unique identifier for the agent managing the asset.
Department IDThe unique identifier for the department assigned to the asset.
Group IDThe unique identifier for the agent group managing the asset.
Workspace IDThe unique identifier for the workspace the asset belongs to. Defaults to the primary workspace if not provided. Applicable only to accounts on Employee Support Mode.
Extra BodyA JSON object of additional fields not covered by the standard inputs. See Freshservice API documentation for more information.

Create or Update Asset (ITAM)​

Creates an asset, or updates the existing asset that matches the supplied name.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
TypeThe specific type of the asset.
NameThe name of the asset.
Serial NumberThe serial number of the asset. Set to d42null to clear the stored value.
Asset NumberThe asset number of the asset.
Service LevelThe operational status of the asset. Freshservice predefines In Service, Spare and Not in Service, and also accepts a custom value.
In ServiceWhether the asset is currently in service. Freshservice expects the strings "yes" or "no" here rather than a boolean.
Device NameThe name of the device this asset is associated with.
Back Connection TypeThe type of back connection used by the asset.
VendorThe name of the vendor that supplied the asset.
Object CategoryThe existing category used to control access when multitenancy is enabled.
TagsA comma-separated list of tags to apply to the asset.
NotesFree-text notes about the asset.
Rack PlacementRack, starting unit, size, orientation, horizontal position, and mounting depth. Supplying a rack makes Start At and Size mandatory.
RackThe name of the rack the asset is mounted in.
Rack IDThe unique identifier for the rack the asset is mounted in.
Start AtThe starting Rack Unit (U) location for the asset. Required when the asset is added to a rack.
SizeThe height of the asset in Rack Units (U). Required when the asset is added to a rack.
OrientationThe mounting orientation. Only "back" has an effect; any other value is ignored by Freshservice.
WhereThe specific mounting location within the rack.
Horizontal PositionThe horizontal position within a Rack Unit, from 0 to 2520 in increments of 252. Each increment is one tenth of the rack width, so 0 is flush-left and 1260 centers the left edge of the asset. Freshservice names this attribute x_pos on the way in and xpos on the way out.
DepthThe mounting depth of the asset. Freshservice defaults to half.
Extra BodyA JSON object of additional fields not covered by the standard inputs. See Freshservice IT Asset Management API documentation for more information.

Create or Update Device (ITAM)​

Creates a device, or updates the existing device that matches the supplied identifier.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
NameThe name of the device. Required when creating a device. If a device with this name already exists, that record is updated instead.
Device IDThe unique identifier of an existing device to update. Supply this, Serial Number or UUID to update; supply Name instead to create.
Serial NumberThe serial number of the device. Values shorter than three characters, and generic values such as 123456789, are silently ignored by Freshservice rather than rejected. Set to d42null to clear the stored value.
UUIDThe universally unique identifier of the device. When a matching UUID is found, that record is updated.
Asset NumberThe asset number of the device.
TypeThe device type.
Physical Subtype IDThe unique identifier for the hardware subtype. Applies only when Type is physical or unknown. System-defined values are 1 (Generic), 2 (Rackable), 3 (Blade), 4 (PDU), 5 (Access Point), 6 (CRAC), 7 (UPS), 8 (TAP), 9 (Branch Circuit Power Meter), 10 (Power Unit), 11 (WorkStation), 12 (ThinClient), 13 (Network Printer), 14 (Laptop) and 15 (Environment Monitor).
In ServiceWhether the device is currently in service. Freshservice expects the strings "yes" or "no" here rather than a boolean.
Network DeviceWhether the device is a network switch. Freshservice expects the strings "yes" or "no" here rather than a boolean.
Virtual HostWhether the device is a virtual host. Freshservice expects the strings "yes" or "no" here rather than a boolean.
Data CenterThe name of the data center housing the device.
Cost CentersA comma-separated list of cost center names to associate with the device. These records must already exist. Freshservice names this attribute customers in the API and Cost Centers in the user interface.
Extra BodyA JSON object of additional fields not covered by the standard inputs. See Freshservice IT Asset Management API documentation for more information.

Create Problem​

Creates a new problem in Freshservice.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
SubjectThe brief summary line describing the problem.
EmailThe email address of the person who reported the problem.
DescriptionThe HTML body content with details about the problem.
Due ByThe timestamp when the problem resolution is expected. Format: ISO 8601 (e.g., 2020-07-20T16:18:46Z).
PriorityThe urgency level that determines the problem's resolution order.
StatusThe current lifecycle stage of the problem.
ImpactThe scope of business disruption caused by the problem.
CategorizationCategory, sub-category, and item-category for the record.
CategoryThe classification group for the problem (e.g., Hardware, Software).
Sub CategoryThe secondary classification within the problem's category.
Item CategoryThe specific item type within the sub-category.
Extra BodyA JSON object of additional fields not covered by the standard inputs. See Freshservice API documentation for more information.

Create Requester​

Creates a new requester in Freshservice.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
First NameThe given name of the requester.
Last NameThe family name of the requester.
Primary EmailThe main email address used to contact the requester.
Job TitleThe role or position held by the requester.
Contact InformationEmail, phone, and other contact channel details.
Secondary EmailsAdditional/secondary emails associated with the requester. Array of email addresses.
Work Phone NumberThe office or desk phone number for the requester.
Mobile Phone NumberThe cell phone number for the requester.
AddressThe physical or mailing address of the requester.
Reporting Manager IDThe unique identifier for the supervisor of the requester.
Department IDsUnique IDs of the departments associated with the requester. Array of ID numbers.
Extra BodyA JSON object of additional fields not covered by the standard inputs. See Freshservice API documentation for more information.

Create Service Request​

Creates a new service request in Freshservice.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Service Item Display IDThe unique identifier for the service catalog item to request.
QuantityThe number of items to include in the service request.
EmailThe email address of the requester. If omitted, the request is created on behalf of the authenticated agent.
Requested ForThe email address of the person on whose behalf the service request is created.
Extra BodyA JSON object of additional fields not covered by the standard inputs. See Freshservice API documentation for more information.

Create Software​

Creates a new software application in Freshservice.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
NameThe display name used to identify the software application.
DescriptionA summary of the software's purpose and capabilities.
Application TypeThe deployment model of the software (Desktop, SaaS, or Mobile).
Managed By IDID of the user managing the software (must be a user in Freshservice).
Additional FieldsAdditional optional fields: includes Status, Notes, Category, and Source.
StatusThe current lifecycle stage of the software in the organization.
NotesFree-text remarks or additional context about the software.
CategoryThe classification group for the software (e.g., service desk application).
SourceThe origin system from where the software details were imported or updated.
Workspace IDThe unique identifier for the workspace the software belongs to. Defaults to the primary workspace if not provided. Applicable only to accounts on Employee Support Mode.
Extra BodyA JSON object of additional fields not covered by the standard inputs. See Freshservice API documentation for more information.

Create Ticket​

Creates a new ticket in Freshservice.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
DescriptionThe HTML body content displayed in the ticket detail view.
SubjectThe brief summary line shown in ticket listings.
EmailThe email address of the person who submitted the ticket.
PriorityThe urgency level that determines the ticket's resolution order.
StatusThe current lifecycle stage of the ticket.
CC EmailsEmail addresses added in the 'cc' field of the incoming ticket email. The value should be an array of strings.
Workspace IDThe unique identifier for the workspace the ticket belongs to.
Extra BodyA JSON object of additional fields not covered by the standard inputs. See Freshservice API documentation for more information.

Deactivate Agent​

Deactivates an agent by ID.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Agent IDUnique ID of the agent to deactivate.

Deactivate Requester​

Deactivates a requester by ID.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Requester IDUnique ID of the requester to deactivate.

Delete Asset (Deprecated)​

Deletes an asset by display ID. Applies to Freshservice accounts created before the March 31, 2026 IT Asset Management release.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Asset Display IDDisplay ID of the asset to delete.

Delete Asset (ITAM)​

Deletes an asset by its unique identifier.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Asset IDThe unique identifier of the asset to delete.

Delete Device (ITAM)​

Deletes a device by its unique identifier.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Device IDThe unique identifier of the device to delete.

Delete Problem​

Deletes a problem by ID.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Problem IDID of the Problem to delete.

Delete Software​

Deletes a software application by ID.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Application IDUnique ID of the software to delete.

Delete Ticket​

Deletes a ticket by ID.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Ticket IDID of the ticket to delete.

Forget Agent​

Permanently removes an agent and associated data.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Agent IDUnique ID of the agent to forget.

Get Agent​

Retrieves details of an agent by ID.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Agent IDThe unique identifier for the agent.

Get Asset (Deprecated)​

Retrieves details of an asset by display ID. Applies to Freshservice accounts created before the March 31, 2026 IT Asset Management release.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Asset Display IDDisplay ID of the asset to retrieve.

Get Asset (ITAM)​

Retrieves details of an asset by its unique identifier.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Asset IDThe unique identifier of the asset to retrieve.
Include ColumnsA comma-separated list of attributes to return for each asset. Freshservice ITAM supports only Include Columns, page and page size as list parameters.

Get Device (ITAM)​

Retrieves details of a device by its unique identifier.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Device IDThe unique identifier of the device to retrieve.

Get Problem​

Retrieves details of a problem by ID.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Problem IDThe unique identifier for the problem.

Get Requester​

Retrieves details of a requester by ID.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Requester IDThe unique identifier for the requester.

Get Software​

Retrieves details of a software application by ID.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Application IDUnique ID of the software to retrieve.

Get Ticket​

Retrieves details of a ticket by ID.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Ticket IDID of the ticket to retrieve.
Additional Query ParametersKey-value pairs appended to the request URL for filtering or other API options.

Get Workspace​

Retrieves details of a workspace by ID.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Workspace IDID of the workspace to retrieve.
Additional Query ParametersKey-value pairs appended to the request URL for filtering or other API options.

List Agents​

Returns a list of all agents.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Fetch AllWhen true, automatically fetches all pages of results.false
PaginationPage and page-size controls.
Items Per PageThe maximum number of results to return per page. Maximum is 100.
Page NumberThe 1-based page number to return.
Additional Query ParametersKey-value pairs appended to the request URL for filtering or other API options.

List Assets (Deprecated)​

Returns a list of all assets. Applies to Freshservice accounts created before the March 31, 2026 IT Asset Management release.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Fetch AllWhen true, automatically fetches all pages of results.false
PaginationPage and page-size controls.
Items Per PageThe maximum number of results to return per page. Maximum is 100.
Page NumberThe 1-based page number to return.
Additional Query ParametersKey-value pairs appended to the request URL for filtering or other API options.

List Assets (ITAM)​

Returns a list of assets.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Fetch AllWhen true, automatically fetches all pages of results.false
PaginationPage and page-size controls.
Items Per PageThe maximum number of results to return per page. Maximum is 100.
Page NumberThe 1-based page number to return.
Include ColumnsA comma-separated list of attributes to return for each asset. Freshservice ITAM supports only Include Columns, page and page size as list parameters.

List Devices (ITAM)​

Returns a list of devices.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Fetch AllWhen true, automatically fetches all pages of results.false
PaginationPage and page-size controls.
Items Per PageThe maximum number of results to return per page. Maximum is 100.
Page NumberThe 1-based page number to return.
Include ColumnsA comma-separated list of attributes to return for each device. Freshservice ITAM supports only Include Columns, page and page size as list parameters.

List Problems​

Returns a list of all problems.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Fetch AllWhen true, automatically fetches all pages of results.false
PaginationPage and page-size controls.
Items Per PageThe maximum number of results to return per page. Maximum is 100.
Page NumberThe 1-based page number to return.
Additional Query ParametersKey-value pairs appended to the request URL for filtering or other API options.

List Requesters​

Returns a list of all requesters.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Fetch AllWhen true, automatically fetches all pages of results.false
PaginationPage and page-size controls.
Items Per PageThe maximum number of results to return per page. Maximum is 100.
Page NumberThe 1-based page number to return.
Additional Query ParametersKey-value pairs appended to the request URL for filtering or other API options.

List Software​

Returns a list of all software applications.

InputCommentsDefault
ConnectionThe Freshservice connection to use.

List Tickets​

Returns a list of all tickets.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Fetch AllWhen true, automatically fetches all pages of results.false
PaginationPage and page-size controls.
Items Per PageThe maximum number of results to return per page. Maximum is 100.
Page NumberThe 1-based page number to return.
FilterThe predefined view used to narrow down the ticket list.
Additional Query ParametersKey-value pairs appended to the request URL for filtering or other API options.

List Workspaces​

Returns a list of all workspaces.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Fetch AllWhen true, automatically fetches all pages of results.false
PaginationPage and page-size controls.
Items Per PageThe maximum number of results to return per page. Maximum is 100.
Page NumberThe 1-based page number to return.
Additional Query ParametersKey-value pairs appended to the request URL for filtering or other API options.

Move Asset (Deprecated)​

Moves an asset to a different workspace. Applies to Freshservice accounts created before the March 31, 2026 IT Asset Management release.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Asset Display IDDisplay ID of the asset to move.
Workspace IDID of the workspace to move the asset to.
Group IDID of the new asset group.
Agent IDID of the new asset agent.

Move Problem​

Moves a problem to a different workspace.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Problem IDID of the Problem to move.
Workspace IDThe unique identifier for the target workspace.
Group IDThe unique identifier for the agent group to assign the problem to.
Owner IDThe unique identifier for the agent to assign as the problem owner.

Move Software​

Moves a software application to a different workspace.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Application IDUnique ID of the software to move.
Workspace IDID of the workspace to move the software to.

Move Ticket​

Moves a ticket to a different workspace.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Ticket IDID of the ticket to move.
Workspace IDID of the workspace to move the ticket to.
Group IDThe unique identifier for the agent group to assign the ticket to.
Responder IDThe unique identifier for the agent to assign as the ticket responder.

Raw Request​

Sends a raw HTTP request to the Freshservice API.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
URLThe path to append to the base URL. The base URL (https://example.freshservice.com/api/v2) is already included. For example, to reach https://example.freshservice.com/api/v2/problems, enter /problems.
MethodThe HTTP method to use.
DataThe HTTP body payload to send to the URL.
Form DataThe Form Data to be sent as a multipart form upload.
File DataFile Data to be sent as a multipart form upload.
File Data File NamesFile names to apply to the file data inputs. Keys must match the file data keys above.
Query ParameterA list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
HeaderA list of headers to send with the request.
Response TypeThe type of data you expect in the response. You can request json, text, or binary data.json
TimeoutThe maximum time that a client will await a response to its request
Retry Delay (ms)The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.0
Retry On All ErrorsIf true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.false
Max Retry CountThe maximum number of retries to attempt. Specify 0 for no retries.0
Use Exponential BackoffSpecifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.false

Search Asset (Deprecated)​

Searches for assets matching a query. Applies to Freshservice accounts created before the March 31, 2026 IT Asset Management release.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Search QueryThe filter expression to search assets. Supported fields are name, asset_tag, and serial_number.
Additional Query ParametersKey-value pairs appended to the request URL for filtering or other API options.

Update Agent​

Updates an existing agent.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Agent IDUnique ID of the agent to update.
RolesRoles of the agent. An array of hashes. See Freshservice API documentation for more information.
Scoreboard Level IDThe Arcade gamification level assigned to the agent.
Department IDsUnique IDs of the departments associated with the agent.
Additional FieldsAdditional optional fields: includes Email, Address, Occasional, Signature, and Can See All Tickets From Associated Departments.
EmailThe primary email address used to identify the agent.
AddressThe physical or mailing address of the agent.
OccasionalWhen true, marks the agent as an occasional (part-time) agent rather than full-time.
SignatureSignature of the agent in HTML format.
Can See All Tickets From Associated DepartmentsWhen true, allows the agent to view tickets filed by other members of associated departments.
Extra BodyA JSON object of additional fields not covered by the standard inputs. See Freshservice API documentation for more information.

Update Asset (Deprecated)​

Updates an existing asset. Applies to Freshservice accounts created before the March 31, 2026 IT Asset Management release.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Asset Display IDThe unique display identifier for the asset.
Asset Type IDThe unique identifier for the asset type classification.
Location IDThe unique identifier for the location where the asset is assigned.
Agent IDThe unique identifier for the agent managing the asset.
Department IDThe unique identifier for the department assigned to the asset.
Group IDThe unique identifier for the agent group managing the asset.
Additional FieldsAdditional optional fields: includes Name, Asset Tag, Impact, Usage Type, and Description.
NameThe display name used to identify the asset.
Asset TagThe tracking label assigned to the asset for inventory purposes.
ImpactThe business impact level if the asset becomes unavailable.
Usage TypeWhether the asset is permanently assigned or a loaner.
DescriptionA detailed summary of the asset specifications or purpose.
Extra BodyA JSON object of additional fields not covered by the standard inputs. See Freshservice API documentation for more information.

Update Asset (ITAM)​

Updates an existing asset by its unique identifier.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Asset IDThe unique identifier of the asset to update.
TypeThe specific type of the asset.
NameThe name of the asset.
Serial NumberThe serial number of the asset. Set to d42null to clear the stored value.
Asset NumberThe asset number of the asset.
Service LevelThe operational status of the asset. Freshservice predefines In Service, Spare and Not in Service, and also accepts a custom value.
In ServiceWhether the asset is currently in service. Freshservice expects the strings "yes" or "no" here rather than a boolean.
Device NameThe name of the device this asset is associated with.
Back Connection TypeThe type of back connection used by the asset.
VendorThe name of the vendor that supplied the asset.
Object CategoryThe existing category used to control access when multitenancy is enabled.
TagsA comma-separated list of tags to apply to the asset.
NotesFree-text notes about the asset.
Rack PlacementRack, starting unit, size, orientation, horizontal position, and mounting depth. Supplying a rack makes Start At and Size mandatory.
RackThe name of the rack the asset is mounted in.
Rack IDThe unique identifier for the rack the asset is mounted in.
Start AtThe starting Rack Unit (U) location for the asset. Required when the asset is added to a rack.
SizeThe height of the asset in Rack Units (U). Required when the asset is added to a rack.
OrientationThe mounting orientation. Only "back" has an effect; any other value is ignored by Freshservice.
WhereThe specific mounting location within the rack.
Horizontal PositionThe horizontal position within a Rack Unit, from 0 to 2520 in increments of 252. Each increment is one tenth of the rack width, so 0 is flush-left and 1260 centers the left edge of the asset. Freshservice names this attribute x_pos on the way in and xpos on the way out.
DepthThe mounting depth of the asset. Freshservice defaults to half.
Extra BodyA JSON object of additional fields not covered by the standard inputs. See Freshservice IT Asset Management API documentation for more information.

Update Device (ITAM)​

Updates an existing device by its unique identifier.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Device IDThe unique identifier of the device to update.
NameThe name of the device. Required when creating a device. If a device with this name already exists, that record is updated instead.
Asset NumberThe asset number of the device.
TypeThe device type.
Physical Subtype IDThe unique identifier for the hardware subtype. Applies only when Type is physical or unknown. System-defined values are 1 (Generic), 2 (Rackable), 3 (Blade), 4 (PDU), 5 (Access Point), 6 (CRAC), 7 (UPS), 8 (TAP), 9 (Branch Circuit Power Meter), 10 (Power Unit), 11 (WorkStation), 12 (ThinClient), 13 (Network Printer), 14 (Laptop) and 15 (Environment Monitor).
In ServiceWhether the device is currently in service. Freshservice expects the strings "yes" or "no" here rather than a boolean.
Network DeviceWhether the device is a network switch. Freshservice expects the strings "yes" or "no" here rather than a boolean.
Virtual HostWhether the device is a virtual host. Freshservice expects the strings "yes" or "no" here rather than a boolean.
Data CenterThe name of the data center housing the device.
Cost CentersA comma-separated list of cost center names to associate with the device. These records must already exist. Freshservice names this attribute customers in the API and Cost Centers in the user interface.
Extra BodyA JSON object of additional fields not covered by the standard inputs. See Freshservice IT Asset Management API documentation for more information.

Update Problem​

Updates an existing problem.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Problem IDID of the Problem to update.
CategorizationCategory, sub-category, and item-category for the record.
CategoryThe classification group for the problem (e.g., Hardware, Software).
Sub CategoryThe secondary classification within the problem's category.
Item CategoryThe specific item type within the sub-category.
Additional FieldsAdditional optional fields: includes Subject, Email, Description, Due By, Priority, Status, and Impact.
SubjectThe brief summary line describing the problem.
EmailThe email address of the person who reported the problem.
DescriptionThe HTML body content with details about the problem.
Due ByThe timestamp when the problem resolution is expected. Format: ISO 8601 (e.g., 2020-07-20T16:18:46Z).
PriorityThe urgency level that determines the problem's resolution order.
StatusThe current lifecycle stage of the problem.
ImpactThe scope of business disruption caused by the problem.
Extra BodyA JSON object of additional fields not covered by the standard inputs. See Freshservice API documentation for more information.

Update Requester​

Updates an existing requester.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Requester IDUnique ID of the requester to update.
Job TitleThe role or position held by the requester.
First NameThe given name of the requester.
Last NameThe family name of the requester.
Contact InformationEmail, phone, and other contact channel details.
Primary EmailThe main email address used to contact the requester.
Secondary EmailsAdditional/secondary emails associated with the requester. Array of email addresses.
Work Phone NumberThe office or desk phone number for the requester.
Mobile Phone NumberThe cell phone number for the requester.
AddressThe physical or mailing address of the requester.
Reporting Manager IDThe unique identifier for the supervisor of the requester.
Department IDsUnique IDs of the departments associated with the requester. Array of ID numbers.
Extra BodyA JSON object of additional fields not covered by the standard inputs. See Freshservice API documentation for more information.

Update Software​

Updates an existing software application.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Application IDThe unique identifier for the software application.
Managed By IDID of the user managing the software (must be a user in Freshservice).
Additional FieldsAdditional optional fields: includes Name, Description, Application Type, Status, Notes, Category, and Source.
NameThe display name used to identify the software application.
DescriptionA summary of the software's purpose and capabilities.
Application TypeThe deployment model of the software (Desktop, SaaS, or Mobile).
StatusThe current lifecycle stage of the software in the organization.
NotesFree-text remarks or additional context about the software.
CategoryThe classification group for the software (e.g., service desk application).
SourceThe origin system from where the software details were imported or updated.
Extra BodyA JSON object of additional fields not covered by the standard inputs. See Freshservice API documentation for more information.

Update Ticket​

Updates an existing ticket.

InputCommentsDefault
ConnectionThe Freshservice connection to use.
Ticket IDID of the ticket to update.
Additional FieldsAdditional optional fields: includes Priority, Status, Source, and Bypass Mandatory.
PriorityThe urgency level that determines the ticket's resolution order.
StatusThe current lifecycle stage of the ticket.
SourceThe channel through which the ticket was created.
Bypass MandatoryTo bypass mandatory fields check while updating the ticket except for requester_id, source. Any business rules trying to mandate certain fields will also be bypassed. All fields configured as mandatory upon closing or resolving the ticket will be skipped while updating the ticket. This can only be passed by an admin.
Extra BodyA JSON object of additional fields not covered by the standard inputs. See Freshservice API documentation for more information.