Improve product adoption and reduce churn by enriching Gainsight with rich, up-to-date customer data from your data warehouse
Supported syncing
| Sync Type | Description | Supported Sync Modes | API reference |
|---|---|---|---|
| Company | Sync data from any source to Company Objects | Upsert, Update | Company endpoint |
| Person | Sync data from any source to Person Objects | Upsert | Person endpoint |
| Custom Objects | Sync data from any source to Custom Objects | Upsert, Update | Custom Object endpoint |
For more information about sync modes, refer to the sync modes docs.
Connect to Gainsight
Go to the Destinations overview page and click the Add destination button. Select Gainsight and click Continue. You can then authenticate Hightouch to Gainsight by entering the following fields into Hightouch:
- Subdomain: You can create domains and subdomains by following these instructions in Gainsight's docs.
- API Key: You can generate an API key by following these instructions in Gainsight's docs.
Sync configuration
Once you've set up your Gainsight destination and have a model to pull data from, you can set up your sync configuration to begin syncing data. Go to the Syncs overview page and click the Add sync button to begin. Then, select the relevant model and the Gainsight destination you want to sync to.
Syncing companies
The Company object is one of the core objects in Gainsight and is used to store information about your customers, including individual customer records.
Record matching
To match rows from your model to companies in Gainsight, you need to select a model column and corresponding Gainsight field. You can match on any filterable, unique field in Gainsight.
Refer to the record matching docs for more information.
Field mapping
Hightouch lets you sync company fields via field mapping. You can map data from any of your model columns to any non read-only company fields.
Delete behavior
The delete behavior you select dictates what to do when a row no longer appears in your model's query results. You have the following options:
| Behavior | Description |
|---|---|
| Do nothing | Keep the company in Gainsight |
| Clear | Remove all the mapped fields, but keep the record in Gainsight |
| Delete | Delete the synced company record from Gainsight |
Syncing people
A Gainsight Person is a standard object that stores unique records of people in the real world.
Record matching
To match rows from your model to people in Gainsight, you need to select the model column that contains values that match the Email field.
Refer to the record matching docs for more information.
Field mapping
Hightouch lets you sync people fields via field mapping. You can map data from any of your model columns to any non read-only people fields.
Delete behavior
The delete behavior you select dictates what to do when a row no longer appears in your model's query results. You have the following options:
| Behavior | Description |
|---|---|
| Do nothing | Keep the person in Gainsight |
| Clear | Remove all the mapped fields, but keep the record in Gainsight |
| Delete | Delete the synced person record from Gainsight |
Syncing custom objects
Hightouch lets you update Low Volume Custom Objects in Gainsight. You can use these objects to store low volume data that needs to be edited frequently.
Hightouch diplays Low Volume custom objects in your Gainsight instance in a picklist at the beginning of your sync configuration. To create custom objects, refer to Gainsight's docs.
Gainsight doesn't support creating or updating High Volume Custom Objects via their API. As a workaround, you can sync your data to S3 and use Gainsight's S3 Connector to import your data into a High Volume Custom Object.
Record matching
To match rows from your model to custom objects in Gainsight, you need to select a model column and corresponding Gainsight field. You can match on any filterable, unique field in Gainsight.
Refer to the record matching docs for more information.
Field mapping
Hightouch lets you sync custom object fields via field mapping. You can map data from any of your model columns to any non read-only custom object fields.
Delete behavior
The delete behavior you select dictates what to do when a row no longer appears in your model's query results. You have the following options:
| Behavior | Description |
|---|---|
| Do nothing | Keep the custom object in Gainsight |
| Clear | Remove all the mapped fields, but keep the record in Gainsight |
| Delete | Delete the synced custom object from Gainsight |
Tips and troubleshooting
Common errors
To date, our customers haven't experienced any errors while using this destination. If you run into any issues, please don't hesitate to . We're here to help.
Live debugger
Hightouch provides complete visibility into the API calls made during each of your sync runs. We recommend reading our article on debugging tips and tricks to learn more.
Sync alerts
Hightouch can alert you of sync issues via Slack, PagerDuty, SMS, or email. For details, please visit our article on alerting.