> ## 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 V2 Connector

## Intro

Freshservice is a cloud-based service desk and IT service management (ITSM) solution. It helps IT organizations streamline their service delivery processes with a strong focus on user experience and employee happiness. Use Domo's Freshservice V2 connector to receive data about agents, agent groups, all tickets, conversions on tickets, and so on. 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 V2 account in the Data Center. This topic discusses the fields and menus that are specific to the Freshservice V2 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 "Adding a DataSet Using a Data Connector").

## Prerequisites

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

* API Key
* Domain

## Connecting to Your Freshservice V2 Account

This section enumerates the options in the **Credentials** and **Details** panes in the Freshservice V2 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" data-aura-rendered-by="33:195;a"><tbody><tr><td colspan="1" rowspan="1"><b> Field </b></td><td colspan="1" rowspan="1"><b> Description </b></td></tr><tr><td colspan="1" rowspan="1"> API Key </td><td colspan="1" rowspan="1"><p> The API Key associated with your Freshservice V2 account. </p><p> 1) Login to your Support Portal. <br /> 2) Select your profile picture on the top right corner of your portal. <br /> 3) Go to the Profile settings Page. Your API key will be available below the Delegate Approvals section to your right. </p></td></tr><tr><td colspan="1" rowspan="1"> Domain </td><td colspan="1" rowspan="1"><b /> The subdomain your account is hosted on. For example, if you log in at <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. </td></tr></tbody></table>

Click **Connect** (or select **Add Account** if you have existing Freshservice V2 accounts in Domo). Once you have entered valid Freshservice V2 credentials, you can use the same account any time you go to create a new Freshservice V2 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 V2 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 V2 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> Agents </p></td><td colspan="1" rowspan="1"><p> Returns information about all agents </p></td></tr><tr><td colspan="1" rowspan="1"><p> AgentGroups </p></td><td colspan="1" rowspan="1"><p> Returns information about agent groups. </p></td></tr><tr><td colspan="1" rowspan="1"><p> All Conversations of Ticket </p></td><td colspan="1" rowspan="1"><p> Returns all conversations of a ticket. </p></td></tr><tr><td colspan="1" rowspan="1"><p> All Tickets </p></td><td colspan="1" rowspan="1"><p> Returns all tickets that have been updated since the selected date. </p></td></tr><tr><td colspan="1" rowspan="1"><p> List All Ticket Fields </p></td><td colspan="1" rowspan="1"><p> Returns a list of all ticket fields. </p></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="What version of the Freshservice API does this connector use?">
    This connector uses version 2 of the Freshservice API (https\://%s.Freshservice.com/api/v2/).
  </Accordion>

  <Accordion title="Which endpoint(s) does each report call in this connector?">
    |                             |                                              |
    | --------------------------- | -------------------------------------------- |
    | **Report Name**             | **Endpoint URL(s)**                          |
    | Agents                      | `/agents/`                                   |
    | Agent Groups                | `/groups/`                                   |
    | All Conversations of Ticket | `/tickets/{ticketId}/conversations`          |
    | All Tickets                 | `/tickets/{ticketId}?include={embedDetails}` |
    | List All Ticket Fields      | `/ticket_fields`                             |
  </Accordion>

  <Accordion title="What kind of credentials do I need to power up this connector?">
    To power up Freshservice v2 connector, you need your Freshservice API Key and Subdomain of your Freshservice account where it is hosted.
  </Accordion>

  <Accordion title="Can I use the same account multiple times to create datasets?">
    Yes
  </Accordion>

  <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 that I need to be aware of?">
    Freshservice allows 1000 API calls per hour.
  </Accordion>

  <Accordion title="What's the difference between this connector and Freshservice connector?">
    With Freshservice V2, you can pay for a higher access level that increases your API limit.
  </Accordion>
</AccordionGroup>