# Freshservice

> Source: https://truto.one/docs/integration-guides/freshservice/

Freshservice connects with an API key and your helpdesk's subdomain.

## Install the Freshservice integration

Install Freshservice from [Available integrations](https://app.truto.one/integrations/available/8103d8ab-802a-456c-8e9b-6345736d4582) in each environment you connect accounts from.

## Find your API key

1. Sign in to Freshservice and click your profile picture in the top-right corner.
   ![Click your profile picture](https://docs-assets.truto.one/freshservice-details-1.png)
2. Open **Profile Settings**.
   ![Profile settings](https://docs-assets.truto.one/freshservice-details-2.png)
3. Your API key is on the right, below the change password section.
   ![API key](https://docs-assets.truto.one/freshservice-details-3.png)

The subdomain is the first part of your Freshservice URL: for `https://acme.freshservice.com`, it is `acme`.

![Freshservice subdomain](https://docs-assets.truto.one/freshservice-details-4.png)

## Connect a Freshservice account

1. Click **Connect Account**.
   ![Click Connect Account](https://docs-assets.truto.one/truto-connect-account.png)
2. Enter a Tenant ID. This can be any ID you choose. Click **Get connection link**.
   ![Get connection link](https://docs-assets.truto.one/truto-connect-account-modal.png)
3. Open the generated link. You can also share it with your customer so they connect their own Freshservice account.
   ![Share connection link](https://docs-assets.truto.one/truto-connect-account-link.png)
4. Select **Freshservice**.
5. Fill in the form and click **Connect**:

   | Field | Required | What to enter |
   |---|---|---|
   | **API Key** | Yes | Your Freshservice API key. See [Find your API key](#find-your-api-key). |
   | **Freshservice Subdomain** | Yes | The first part of your Freshservice URL: for `https://acme.freshservice.com`, enter `acme`. |
6. Close the tab when you see the connection successful message. The new account appears under **Integrated Accounts**. Click its Account ID to see its details and make API calls.