Skip to main content

Gainsight Setup Guide

Prerequisites

  • An active Gainsight NXT account
  • Admin access in Gainsight to generate an API Access Key

Setup Guide

Step 1: Locate Your Gainsight Subdomain

Your Gainsight subdomain is the prefix in your Gainsight URL:

https://<subdomain>.gainsightcloud.com

For example, if your URL is:

https://acme.gainsightcloud.com

Then your subdomain is:

acme

You will need this value when configuring the connector in Matia.


Step 2: Generate a Gainsight API Token

Matia uses Gainsight’s REST API Access Key for authentication.

  1. Log into your Gainsight instance.
  2. Navigate to AdministrationConnectors 2.0 (or API Integrations, depending on your environment).
  3. Open the REST API section.
  4. Click Generate Access Key or Regenerate Access Key if one already exists.
  5. Copy the generated API Token. This key will be used by Matia to send data into Gainsight.

Note: Gainsight API Keys are long-lived but may rotate if manually regenerated. If the key changes, you must update it inside Matia.


Step 3: Complete Configuration in Matia

In Matia → DestinationsAdd DestinationGainsight:

  1. Enter your Gainsight Subdomain (from Step 1).
  2. Enter your API Token (from Step 2).
  3. Enter an Asset Name
  4. (Optional) Enter a Description
  5. (Optional) Assign Tags
  6. Select an Owner
  7. Verify that your Gainsight environment is successfully connected by clicking on Test Connection
  8. Click Connect