Gainsight CS NXT

Gainsight CS NXT is a comprehensive customer success platform that helps businesses reduce churn, increase expansion revenue, and improve customer satisfaction through automated workflows, health scoring, journey mapping, and predictive analytics to optimize customer lifecycle management.

Power end-to-end data operations for your Gainsight CS NXT API with Nexla. Our bi-directional Gainsight CS NXT connector is purpose-built for Gainsight CS NXT, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Gainsight CS NXT or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Gainsight CS NXT workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

• Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
• Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
• API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
• Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites

Before creating a Gainsight CS NXT credential, you need to obtain an API Access Key from your Gainsight CS NXT account. The API Access Key is required to authenticate with the Gainsight CS NXT API.

To obtain your API Access Key, you need to have a Gainsight CS NXT account with API access enabled. Once you have access to your account, you can generate an API Access Key from your Gainsight CS NXT administration settings. The API Access Key is sent in the Accesskey header for all API requests to the Gainsight CS NXT API. For detailed information about API Access Key setup and authentication, refer to the Gainsight CS NXT API documentation.

Authenticate

Credentials required

Field	Required	Secret	Description
API Base Url	Yes	No	Your Gainsight CS API URL. Usually of the format https://[yourcompany].gainsightcloud.com
Access Key	Yes	Yes	Your Gainsight CS API Access Key. See https://support.gainsight.com/SFDC_Edition/Connectors/04API_Integration/Generate_API_Access_Key for instructions.

Create a credential in Nexla

1. After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

New Credential Overlay – Gainsight CS NXT

2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

3. Enter your Gainsight CS NXT API base URL in the API Base Url field. This should be your Gainsight CS API URL, usually of the format https://{yourcompany}.gainsightcloud.com where {yourcompany} is your company identifier. The API base URL is used to construct the full endpoint URLs for API requests.

   The API base URL should be of the format https://{yourcompany}.gainsightcloud.com where {yourcompany} is your company identifier. For detailed information about determining your API base URL, see the Gainsight CS NXT API documentation.

4. Enter your Gainsight CS NXT API Access Key in the Access Key field. This is the API Access Key you obtained from your Gainsight CS NXT administration settings. The API Access Key is sent in the Accesskey header for all API requests to the Gainsight CS NXT API.

   Keep your API Access Key secure and do not share it publicly. The API Access Key provides access to your Gainsight CS NXT account and should be treated as sensitive information. You can view and manage your API Access Keys in your Gainsight CS NXT administration settings. For detailed information about obtaining and managing API Access Keys, see the Gainsight CS NXT API documentation.

5. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation.

Use as a data source

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Gainsight CS NXT connector tile, then select the credential that will be used to connect to the Gainsight CS NXT instance, and click Next; or, create a new Gainsight CS NXT credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Gainsight CS NXT endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

Get Companies

Read one or more records that match a specific criteria from the Company object.

• Enter the query criteria for companies to fetch in the Query for Companies to Fetch field. This should be a JSON object containing the query parameters, including select (array of field names to retrieve), limit (maximum number of records), and offset (pagination offset). The default value includes a sample query with common company fields if not specified.

• The endpoint uses POST requests to https://{base_url}/v1/data/objects/query/Company with a JSON body containing the query criteria. The endpoint URL is automatically constructed based on your Gainsight CS NXT API base URL from the credential configuration.
• The endpoint does not use pagination and returns all matching company records in a single request.
• The endpoint will return all company records matching the specified query criteria. The response data is extracted from the data array in the API response ($.data[*]), with each company record processed individually.

The query should be a valid JSON object with select, limit, and offset parameters. The select parameter should be an array of field names you want to retrieve from the Company object. The endpoint uses a static URL (iteration.type: static.url) and does not require pagination. The response data path is $.data[*], which extracts all items from the data array in the API response. For detailed information about querying companies, see the Gainsight CS NXT API documentation.

Get Custom Objects

Read one or more records that match a specific criteria of a custom object.

• Enter the API name of the custom object to fetch in the Custom Object to Fetch field. This should be the API name of the custom object (e.g., CustomObjectName__gc). The default value is CustomObjectName__gc if not specified.

• Enter the query criteria for custom objects to fetch in the Query for Custom Objects to Fetch field. This should be a JSON object containing the query parameters, including select (array of field names to retrieve), limit (maximum number of records), and offset (pagination offset). The default value includes a sample query if not specified.

• The endpoint uses POST requests to https://{base_url}/v1/data/objects/query/{object_name} with a JSON body containing the query criteria. The endpoint URL is automatically constructed based on your Gainsight CS NXT API base URL from the credential configuration and the custom object name.
• The endpoint does not use pagination and returns all matching custom object records in a single request.
• The endpoint will return all custom object records matching the specified query criteria. The response data is extracted from the data array in the API response ($.data[*]), with each custom object record processed individually.

Custom object names should be the API name of the custom object (typically ending with __gc). The query should be a valid JSON object with select, limit, and offset parameters. The select parameter should be an array of field names you want to retrieve from the custom object. The endpoint uses a static URL (iteration.type: static.url) and does not require pagination. The response data path is $.data[*], which extracts all items from the data array in the API response. For detailed information about querying custom objects, see the Gainsight CS NXT API documentation.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration

Gainsight CS NXT data sources can also be manually configured to ingest data from any valid Gainsight CS NXT API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

Gainsight CS NXT API endpoints typically follow the pattern https://{yourcompany}.gainsightcloud.com/v1/{endpoint_path}, where {yourcompany} is your company identifier from the credential configuration. The endpoint requires API Access Key authentication via the Accesskey header, which is handled automatically by your credential configuration.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Gainsight CS NXT data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.

Use as a destination

Click the + icon on the Nexset that will be sent to the Gainsight CS NXT destination, and select the Send to Destination option from the menu. Select the Gainsight CS NXT connector from the list of available destination connectors, then select the credential that will be used to connect to the Gainsight CS NXT organization, and click Next; or, create a new Gainsight CS NXT credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure destinations to send data to common Gainsight CS NXT endpoints. Select the endpoint to which data will be sent from the Endpoint pulldown menu. Then, click on the template in the list below to expand it, and follow the instructions to configure additional endpoint settings.

Insert one or more companies

Insert one or more records into the Company object.

• This endpoint automatically inserts one or more company records into your Gainsight CS NXT account using data from your Nexset. No additional configuration is required beyond selecting this endpoint template.
• The endpoint uses POST requests to https://{base_url}/v1/data/objects/Company. The endpoint URL is automatically constructed based on your Gainsight CS NXT API base URL from the credential configuration.
• The endpoint sends data from your Nexset as the request body in JSON format. The request body is automatically formatted according to the schema fields and data mapping you configure. Each batch of records will be sent as a JSON object containing a records array with the company data to insert.
• Batch mode is enabled for this endpoint. Records are automatically batched into groups of 50 records per request. If you need to insert multiple companies, you can send multiple records, and they will be automatically batched for efficient processing.
• This endpoint does not automatically create a data source to track the responses received from the Gainsight CS NXT API after each call.

The request body must be properly formatted JSON that matches the Gainsight CS NXT API specification for inserting companies. The request body is automatically transformed to include a records array containing your Nexset data. The endpoint requires API Access Key authentication via the Accesskey header, which is handled automatically by your credential configuration. The Content-Type: application/json header is automatically included in requests. Batch mode is enabled by default (batch.mode: true) with a batch size of 50 records per request. For detailed information about inserting companies, including required fields, field names, and request formats, see the Gainsight CS NXT API documentation.

Insert one or more custom object records

Insert one or more records into a custom object.

• Enter the API name of the custom object to insert records into in the Custom Object Name field. This should be the API name of the custom object (e.g., CustomObjectName__gc). The default value is CustomObjectName__gc if not specified.

• The endpoint uses POST requests to https://{base_url}/v1/data/objects/{object_name}. The endpoint URL is automatically constructed based on your Gainsight CS NXT API base URL from the credential configuration and the custom object name.
• The endpoint sends data from your Nexset as the request body in JSON format. The request body is automatically formatted according to the schema fields and data mapping you configure. Each batch of records will be sent as a JSON object containing a records array with the custom object data to insert.
• Batch mode is enabled for this endpoint. Records are automatically batched into groups of 50 records per request. If you need to insert multiple custom object records, you can send multiple records, and they will be automatically batched for efficient processing.
• This endpoint does not automatically create a data source to track the responses received from the Gainsight CS NXT API after each call.

Custom object names should be the API name of the custom object (typically ending with __gc). The request body must be properly formatted JSON that matches the Gainsight CS NXT API specification for inserting custom object records. The request body is automatically transformed to include a records array containing your Nexset data. The endpoint requires API Access Key authentication via the Accesskey header, which is handled automatically by your credential configuration. The Content-Type: application/json header is automatically included in requests. Batch mode is enabled by default (batch.mode: true) with a batch size of 50 records per request. For detailed information about inserting custom object records, including required fields, field names, and request formats, see the Gainsight CS NXT API documentation.

Manual configuration

Gainsight CS NXT destinations can also be manually configured to send data to any valid Gainsight CS NXT API endpoint. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the content format, endpoint URL, request headers, attribute exclusions, record batching, and response webhooks.

The Gainsight CS NXT API typically uses JSON format for request bodies. Endpoint URLs follow the pattern https://{yourcompany}.gainsightcloud.com/v1/{endpoint_path}, where {yourcompany} is your company identifier from the credential configuration, and require API Access Key authentication via the Accesskey header, which is handled automatically by your credential configuration.

Save & activate

Once all endpoint settings have been configured, click the Done button in the upper right corner of the screen to save and create the destination. To send the data to the configured Gainsight CS NXT endpoint, open the destination resource menu, and select Activate.

The Nexset data will not be sent to the Gainsight CS NXT endpoint until the destination is activated. Destinations can be activated immediately or at a later time, providing full control over data movement.