Overview
Torii integrates with Gainsight and syncs:
| User Fields | License Types |
|---|---|
| Name, Email, Status (inactive Gainsight users are shown as deleted), Role (Super Admin / User) | Full, Viewer, Viewer Analytics (paid); Internal Collaborator, External (free) |
- You can constantly stay updated with application information from our Integrations Page >> Integration Capabilities button >> Integration Capabilities table.
Requirements
Accounts & Permissions
To connect this integration, we require the following:
- A Gainsight user with the Super Admin role who is in an active state in User Management. Only an active Super Admin can generate the access key.
Required keys
- Gainsight domain - the full host name of your Gainsight org, for example acme.gainsightcloud.com.
- Access Key - the Gainsight API access key of your organization.
How to Generate the Required Values
Step 1: Generate the Access Key
- Sign in to Gainsight as an active Super Admin.
- Navigate to Administration >> Connectors 2.0.
- Click Create Connection. The Create Connection dialog box appears.
- From the Connector dropdown list, select Gainsight API.
- In the Name of the connection field, enter a name for the connection.
- In Authentication Type, select Access_Key.
- Click Generate Access Key.
- Copy the generated access key.
Important
Only one access key can exist per Gainsight organization. If your organization already uses an access key in other integrations, do not generate a new one: re-generating the key causes API requests that use the old key to fail until they are updated with the new key.
Step 2: Find your Gainsight domain
- Copy the host name you use to open Gainsight, for example acme.gainsightcloud.com (without https://).
How to Connect the Integration
- Go to the Integrations page in Torii.
- Search for Gainsight and click Connect.
- Enter the Account Name, Gainsight domain and Access Key.
- Click Connect.
Actions
- Create User - creates an internal user in Gainsight with an email, first name, last name and an optional license type (Full, Viewer, Viewer Analytics or Internal Collaborators). Gainsight does not send a welcome email.
- Update User - updates the first name, last name or license type of an existing Gainsight user.
- Deactivate User - makes a Gainsight user inactive. Gainsight does not allow deleting users, and an inactive user no longer holds a license.
Gainsight allows 100 user management API requests per hour and 1,000 per day for your organization. Syncs and actions count toward this limit.
Q&A
Q: What should I enter in the "Account Name" field?
A: The Account Name field lets you connect multiple Gainsight accounts to Torii. The value can be anything you choose. It is only used to distinguish between your connected accounts. Make sure to use a unique Account Name for each account: connecting a different account with an Account Name that is already in use will overwrite the existing account's data, so choosing distinct names is your responsibility.
For any further questions, please contact Torii Support.