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

# FreshService Connector

## Intro

FreshService is an IT service desk management system.   To learn more about the FreshService API, visit their page ([http://api.freshservice.com/](http://api.freshservice.com/ "http://api.freshservice.com/") ).

You connect to your FreshService account in the Data Center. This topic discusses the fields and menus that are specific to the FreshService connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").

## Prerequisites

To connect to your FreshService account and create a DataSet, you must have the following:

* Domain
* Your FreshService account Username
* Your FreshService account Password

## Connecting to Your FreshService Account

This section enumerates the options in the **Credentials** and **Details** panes in the FreshService Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").

## Credentials Pane

This pane contains fields for entering credentials to connect to your FreshService account. The following table describes what is needed for each field:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p><span class="s1"> Field </span></p></th><th colspan="1" rowspan="1"><p><span class="s1"> Description </span></p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Domain </p></td><td colspan="1" rowspan="1"><p> The subdomain your account is hosted on. For example, if you log into <a href="http://domo.freshservice.com" rel="noopener" target="_blank"> domo.freshservice.com </a>, you would just enter "domo" in this field. You MUST have SSL enabled on your domain. </p></td></tr><tr><td colspan="1" rowspan="1"> Username </td><td colspan="1" rowspan="1"> The username used to log in to your Fresh Service account </td></tr><tr><td colspan="1" rowspan="1"> Password </td><td colspan="1" rowspan="1"> The password used to log in to your Fresh Service account </td></tr></tbody></table>

Once you have entered valid FreshService credentials, you can use the same account any time you go to create a new FreshService DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Managing User Accounts for Connectors](https://domo-support.domo.com/s/article/360042926054?language=en_US "Managing User Accounts for Connectors").

## Details Pane

This pane contains a single menu from which you select a FreshService report.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> Select the FreshService report you want to run. The following reports are available: </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"><p><b> S. No </b></p></td><td colspan="1" rowspan="1"><p><b> Report Name </b></p></td><td colspan="1" rowspan="1"><p><b> Description </b></p></td></tr><tr><td colspan="1" rowspan="1"><p> 1 </p></td><td colspan="1" rowspan="1"><p> Agents </p></td><td colspan="1" rowspan="1"><p> Returns a list of active agents. </p></td></tr><tr><td colspan="1" rowspan="1"><p> 2 </p></td><td colspan="1" rowspan="1"><p> Assets </p></td><td colspan="1" rowspan="1"> Returns all the assets in your list. </td></tr><tr><td colspan="1" rowspan="1"><p> 3 </p></td><td colspan="1" rowspan="1"><p> Changes </p></td><td colspan="1" rowspan="1"> Returns a list of the changes in your service desk. This report requires the 'Garden' level Fresh Service pricing plan or higher. </td></tr><tr><td colspan="1" rowspan="1"><p> 4 </p></td><td colspan="1" rowspan="1"><p> Departments </p></td><td colspan="1" rowspan="1"> Returns all the departments in your list. </td></tr><tr><td colspan="1" rowspan="1"><p> 5 </p></td><td colspan="1" rowspan="1"><p> Problems </p></td><td colspan="1" rowspan="1"> Returns all of the problems in your service desk. This report requires the 'Garden' level Fresh Service pricing plan or higher. </td></tr><tr><td colspan="1" rowspan="1"><p> 6 </p></td><td colspan="1" rowspan="1"><p> Releases </p></td><td colspan="1" rowspan="1"> Returns all of the releases in your service desk. This report requires the 'Garden' level Fresh Service pricing plan or higher. </td></tr><tr><td colspan="1" rowspan="1"><p> 7 </p></td><td colspan="1" rowspan="1"><p> Tasks </p></td><td colspan="1" rowspan="1"> Returns all of the tasks for the authenticated user. </td></tr><tr><td colspan="1" rowspan="1"><p> 8 </p></td><td colspan="1" rowspan="1"><p> Tickets </p></td><td colspan="1" rowspan="1"> Returns all of the tickets in your service desk. </td></tr></tbody></table></td></tr></tbody></table>

## Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").

## FAQs

<AccordionGroup>
  <Accordion title="How often can the data be updated?">
    DataSets should be updated once per day only, due to FreshService's API call limits.
  </Accordion>

  <Accordion title="Are there any API limits I should be aware of?">
    FreshService allows 1000 API calls per day.
  </Accordion>
</AccordionGroup>
