> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oleria.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Freshservice

> Connect your Freshservice domain to Oleria to continuously discover agent and group access across your IT service management platform.

Freshservice is an IT service management (ITSM) platform for ticketing and asset management. Connect your Freshservice domain to Oleria to bring agent and group access into your identity and access graph, without a dedicated Freshservice-specific integration.

## What Oleria discovers

* Agent accounts and profile attributes synced from Freshservice's directory.
* Groups and their memberships.

Oleria uses this data for dormant account detection and access reviews, refreshed on Freshservice's standard sync schedule.

## Prerequisites

* Admin access in Freshservice with permission to generate an API key for a service account.
* Admin access on the Oleria platform to add a new integration.

<Note>
  The exact location of these settings can change over time. If the steps below don't match what you see, refer to Freshservice's own API documentation.
</Note>

## Get your SCIM credentials from Freshservice

<Steps>
  <Step title="Generate an API key in Freshservice">
    Sign in to Freshservice as an admin, go to **Admin** → **API** → **API Key**, and generate an API key for the integration service account.
  </Step>

  <Step title="Copy your SCIM Base URL and Authentication token">
    Copy both values before you leave the page - you'll paste them into Oleria in the next section:

    * **SCIM Base URL** - the HTTPS API endpoint for your Freshservice domain.
    * **Authentication token** - the API key you generated.

    <Note>
      Copy the key now. Many applications display it only once. Store it securely and rotate it per your organization's security policy.
    </Note>
  </Step>
</Steps>

## Connect Freshservice to Oleria

<Steps>
  <Step title="Open the integration">
    Go to your Oleria workspace, select **Integrations**, then select the **Freshservice** tile.
  </Step>

  <Step title="Complete the connection form">
    Select **Continue** and fill in the connection form:

    | Field                | Notes                                                                                       |
    | :------------------- | :------------------------------------------------------------------------------------------ |
    | Instance name        | Optional. Short, recognizable label for this connection (for example, `freshservice-prod`). |
    | SCIM Base URL        | Required. The HTTPS API endpoint copied from Freshservice.                                  |
    | Authentication token | Required. The API key issued by Freshservice.                                               |
  </Step>

  <Step title="Save the integration">
    Select **Connect** to validate the credentials and save the integration.
  </Step>
</Steps>

## Verify the integration

Confirm the new instance appears in your Oleria workspace under **Connected Integrations** with a status of **Healthy**. Oleria syncs agents and groups from Freshservice on the standard SCIM provisioning schedule once the initial sync completes.

<Note>
  If Freshservice rotates your API key, update the Authentication token in Oleria by editing the integration.
</Note>

## Governance actions

Oleria can also invoke lifecycle actions in Freshservice when the key you provide has write access:

* Enable or disable a user account
* Add or remove a user from a group
* Create a new user or group

<Note>
  Many teams start with a read-only key for visibility, then grant write access once they're ready to automate remediation in Freshservice.
</Note>

## Contact us

For questions about this integration, contact us at [support@oleria.com](mailto:support@oleria.com).