🧰
The Basics
⤵️ Data Sources
🛫
Destinations (app)
Gainsight
This page describes how to use Census with Gainsight.
🏃♀️ Getting started
This guide shows you how to use Census to connect your Gainsight account to your data warehouse and create your first sync.
Prerequisites
Before you begin, you'll need the following:
- Gainsight account: You need your Gainsight domain as well as an API Access Key for the Gainsight API
- Credentials for your data warehouse: For details, see the guide for your specific technology.
Step 1: Generate Access Token 🔑
🔑
Within Gainsight, click on the Sidebar > Administration > Integrations > Connectors 2.0
Click this and click on the Create Connection button in the top right, then select the Gainsight API
Do not select the GS Bulk API, select the Gainsight API
Copy the Access Key after hitting Edit Connection
Step 2: Connect Gainsight as a Service Connection
Click Add Service and select Gainsight. Then paste your Access Key for the Gainsight API. Also, paste in the domain for your Gainsight account
Click Save Connection and ensure that Gainsight passes the connectivity test
With a , we are good to move on to the data!
✅
Step 3: Create a Model
Here you will have to write SQL queries to select the data you want to see in Gainsight. Here are some ideas of data you should select.
- New user sign-ups
- Product usage data for customers
- CSAT scores
- Contract values
Once you have created your model, click Save.
Step 4: Create your first Sync
In the " What data do you want to sync?" section
- For the Source, select the model you created in step 3
- Or you can select a Table or View from your Warehouse
Next up is the "Where do you want to sync data to?" section
- Pick Gainsight from step 2 as the Connection
- For Object, pick the table you want to sync data to
For the " How should changes to the source be synced?" section
- Select your preferred behavior. Update only is a great place to start if the object already exists in Gainsight. Update or Create is great for sending data from the warehouse into Gainsight that might not already be there (like all users from your warehouse to the Gainsight Person object).
Finally, select the fields you want to update in the Mapper in the "Which Fields should be updated?" section.
The end result should look something like this:
Confirm the mappings and click Next in the bottom right corner. On the next page, click the run a sync now checkbox and click on Create Sync
That's it, in 4 steps you have connected your Data Source to Gainsight!
🎉
🗄 Supported Objects
Object Name
Supported?
Identifiers
Person
✅
Email
Company
✅
Name
Company Person
✅
UniqueId for Census. Company Name and Person Email are required
Relationship Person
✅
UniqueId for Census. Company Name, Person Email, and Relationship Name are required
Custom Object
🔜
🔄 Supported Sync Behaviors
Behaviors
Supported?
Objects?
Update or Create
✅
All
Update Only
✅
Company
🚑 Need help connecting to Gainsight?
Last modified 8d ago