Skip to main content
Gainsight Inc.

Load to HubSpot Action Type

Gainsight NXT


IMPORTANT: Gainsight is gradually rolling out this feature. Please contact the Gainsight support team to have it enabled for your tenant.

This article helps the admin to configure the Load to HubSpot action type using Horizon Rules in the Rules Engine.


Admins can configure the Load to HubSpot Action to sync data from Gainsight  to HubSpot. The Rules Engine provides the ability to prepare the dataset from various standard and custom objects of Gainsight, and the Load to HubSpot Action sends the data to the following objects of HubSpot:

  • Company
  • Contact
  • Deal
  • Line Item
  • Product
  • Ticket
  • Engagements ( Call, Email, Meeting, Notes, Tasks )

Gainsight recommends reading the configuration of the Rules Details, Data Setup, and Schedule steps before reading this article. For more information, refer to the Create New Rule section of the Rules Engine Horizon Experience Overview article.

Example Business Use Case:

Consider that the CSM wants to communicate some data back to HubSpot, such as Feedback Surveys, NPS Scores,  Health ScoresTimeline Entries, Renewal Deals, and so on, so that individuals working in HubSpot on the same Company or Contact can leverage these insights from the CS and work more efficiently with their customers.

The Load to HubSpot Action is used to upsert/update these values in the target fields of the HubSpot object.

Configure Load to HubSpot Action Type

To configure the Load to HubSpot Action type:

  1. In the Action Setup step, hover over the dataset. The Add Action icon appears.
  2. Click the Add Action icon. The Add Criteria slide-out panel appears.
  3. (Optional) Click Add Criteria to define filter criteria for the dataset.
  4. Click Skip This Step to navigate to the Add Actions step.
  5. From the Create Action drop-down list, select the Load to HubSpot Action type.

Ishan Nagar - Gainsight - Slack 2023-10-26 at 12.26.43 PM.jpg

  1. In the Load to HubSpot section, provide the following details:
    1. From the HubSpot Connection drop-down list, select the HubSpot connection.

      Note: The HubSpot Connection must be authenticated on the Connectors 2.0 page.
    2. From the HubSpot Object drop-down list, select objects to which you want to transfer the data.

      • If Multiple objects are selected, the records are associated with each other.
      • Few Activities are grayed and can only be selected if corresponding parent objects are selected. For example, select Company to enable Email activity.

        Ishan Nagar - Gainsight - Slack 2023-10-26 at 12.28.32 PM.jpg
    3. From the Operation drop-down list, select one of the following:
      • Update: Updates the existing record as per the field mapping.
      • Upsert: Updates any matching records and creates new records if no matching records are found.
      • Custom Operation: Select Update / Upsert operation for the individual HubSpot objects selected above.
    4. (Optional) Description: Enter a description for the rule action.

Ishan Nagar - Gainsight - Slack 2023-10-26 at 12.30.17 PM.jpg

  1. In order to load data to objects, field mapping must be done. To map fields, click Add Fields.
  2. From the Add Fields drop-down list, select either of the following types of fields to add to the action.
    • Source Field: Source Field: This option lets you select source field(s) from the dataset prepared in Gainsight objects while configuring the rule and map it to the target field in the HubSpot object. To select source field(s):

      1. Click Source Field. The Select Fields slide-out panel appears.
      2. Select the checkbox of the source fields from where the data must be fetched.
      3. Click Select. The selected source fields are added to the Field Mappings section.
      4. Select the Target Fields of HubSpot Object where the data should be loaded.
        1. From the Select HubSpot Object drop-down, select the target object.
        2. Select the corresponding Target Fields.
  3. (Optional) Add a Default Value.

Note: This value is loaded in the target field in case the source field value is invalid or not available.

Ishan Nagar - Gainsight - Slack 2023-10-26 at 12.30.17 PM.jpg

  • Custom Field:  This option lets you provide a custom value to the target field in the HubSpot object. To  provide a custom value to the target field in the HubSpot object configure the following details:
    1. Click Custom Field.
    2. Click the Target Fields drop-down list:
      1. From the Select HubSpot Object drop-down, select the target object.
      2. Select the corresponding Target Fields.
    3. Select Source Field.
    4. Enter the value that must be loaded in the selected target fields.

Ishan Nagar - Gainsight - Slack 2023-10-26 at 12.30.17 PM.jpg

  1. Click Save Actions. The Load to HubSpot Action Type is saved successfully.

Required Properties

To load records to HubSpot, following points need to be considered when importing files:

  • When Importing and associating multiple objects, ensure you include information about associated records or activities in the same row or record.
  • To update existing records, associate records, and avoid duplication records, your files must include a unique identifier property for each object.

Gainsight recommends to map RecordID of selected objects to HubSpot for pushing back data.RecordID is the unique ID in HubSpot that identifies records. For update operation,  ensure to link RecordID as described above. However, for an insert operation, map the required fields based on the following logic:

Objects Fields
  • First Name
  • Last Name
  • Email
  • Name
  • Company Domain Name
Deals (when creating new deals)
  • Deal Name
  • Pipeline
  • Deal Stage
Tickets (when creating new tickets)
  • Ticket Name
  • Pipeline
  • Ticket Status
Product( when creating new products)
  • Unit Price
  • Name
Line Items
  • Name
  • Quantity
  • Price
  • RecordID of associated deal
  • Deal Name
Line Items (when associating with a product)
  • ProductID of the product

Note: When importing line items with deals, the import will not update the deal amount.To update the associated deal amount, you can manually edit the line items or associate the line items with a deal in HubSpot.

  • Call Notes
  • Email Body
  • Email Direction (Incoming or Outgoing)
  • Meeting Description
  • Meeting start time
  • Meeting end time
  • Notes Body
  • Task Title
  • Due Date


  • To associate one record with multiple activities or records of another object, include the record’s unique identifier in multiple rows for each record you want to associate.
  • To know more about data import failures and errors, refer to this Review and troubleshoot import errors article.
  • Was this article helpful?