Skip to content
Connectors/Marketplace/
/
Gainsight
Last updated

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 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