## Gainsight integration

Gainsight is a customer success platform for managing customer health, relationships, and engagement. Integrating Gainsight with Frontegg lets your application manage companies, persons, and relationships, work with Calls to Action (CTAs) and success plans, and query custom objects on behalf of your users — all through Frontegg's integration layer. Gainsight authenticates with a machine-to-machine (M2M) OAuth 2.0 client credentials grant, so there is no user redirect: the gateway exchanges a Client ID and Client Secret directly for an access token against your tenant.

Prerequisites
- A [Gainsight](https://www.gainsight.com/) NXT account
- **Super admin** access (M2M OAuth connections can only be created by super admins)


### Connect Gainsight

Gainsight issues M2M OAuth credentials from a connection you create in Connectors 2.0. You will also need your Gainsight **tenant URL** — the host of your Gainsight API.

#### Step 1: Create a connection in Connectors 2.0

Sign in to Gainsight and go to **Administration → Connectors 2.0**, then click **Create Connection**. From the **Connector** dropdown, select **Gainsight API**, enter a **Name** for the connection (for example, `Frontegg Integration`), and set **Authentication Type** to **OAuth**.

#### Step 2: Generate the OAuth credentials

Click **Generate OAuth Credentials**. Gainsight generates an **OAuth API Key** (your Client ID) and an **OAuth API Secret** (your Client Secret). Copy both values.

Copy your Client Secret now
The OAuth API Secret is your Client Secret — treat it like a password. If it is exposed, use **Re-Generate Secret** on the connection to rotate it (the previous secret stays valid for up to 24 hours).

#### Step 3: Note your tenant URL

Your **tenant URL** is your Gainsight API host — for example, `companyapi.gainsightcloud.com` (or a custom domain such as `companyapi.yourcompany.com`). Use the host only, without `https://` or a trailing slash.

### Configure the Frontegg portal

Once you have your **Client ID**, **Client Secret**, and **tenant URL**, configure the integration in the Frontegg portal:

1. Open the **Frontegg portal** and navigate to [ENVIRONMENT] → Integrations → Gainsight.
2. Enter the **Client ID** (OAuth API Key) and **Client Secret** (OAuth API Secret).
3. Enter your **Gainsight tenant URL** — the host only (for example, `companyapi.gainsightcloud.com`).
4. Click **Save**.


Keep your credentials secure
Never share or commit your Client Secret to version control.

### Additional resources

- [OAuth for Gainsight APIs](https://support.gainsight.com/gainsight_nxt/01Onboarding_and_Implementation/Onboarding_for_Gainsight_NXT/Login_and_Permissions/OAuth_for_Gainsight_APIs)
- [Generate REST API Key (Gainsight Connectors)](https://support.gainsight.com/gainsight_nxt/Connectors/API_Integrations/Generate_REST_API_Key)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)