User Guide

Step 1 —Connect HubSpot

Navigate to Settings in the side navigation and open the Integrations tab.

From the Integration panel, select HubSpot and click + Connect, then sign in and authorize access to complete the connection.

Step 2 —Account Confirmation

Once authentication is complete, HubSpot will show a green Connected status on the Factori Integrations page.

Click Configure to proceed with data setup and field mapping.

Step 3 —Data Import

Inside the HubSpot configuration panel:

  • Click Pull Data → imports contact records
  • Click Sync Properties → retrieves HubSpot metadata

Step 4 —Field Mapping

Map your HubSpot properties to Factori fields, ensuring at least one unique identifier is selected from the available options given below.

Once mapping is complete, click Save to apply the configuration. You can also click Reset at any time to clear and reconfigure the field mapping.

Step 5 —Select Enrichment

Navigate to the Lists module, click + Enrich, and choose HubSpot as the source.

In the dialog box that appears, select Manual Enrichment and click Confirm to continue. [Scheduled Enrichment will be available soon]

Step 6 —Select Contacts to Enrich

Choose either All Contacts or Segments (HubSpot Lists) for enrichment.

  • Option A — All Contacts - Enrich all imported records.
  • Option B — Segment (HubSpot List) - Use dropdown to select a specific HubSpot list.

    Note: Previously imported lists will appear greyed out to prevent duplication.

Step 7 —Monitor Matching Progress

Under the Integrations tab in the Lists module, you will see the Matching status.

Once finished, it will change to Match Complete. Click Confirm to proceed further.

StatusMeaning
MatchingIdentity resolution in progress
Match CompleteMatching finished

Step 8 —Review Credits & Run

After your confirmation is provided, the Run Enrichment popup will appear.


The confirmation model provides full visibility into credit usage before execution, including:

  • Required Credits – Total credits needed for the selected records
  • Available Balance – Remaining credits in your account

You can then choose:

  • Enrich – Start the enrichment process
  • View List – Review the selected records before proceeding

Step 9 —Review Credits & Run

Once records are displayed in the table view, you can manage enrichment at a granular level:

  • Selective Enrichment – Select specific rows and click Enrich to process only those contacts.

  • Show Enriched Only – Enable this toggle to display only successfully enriched records and hide unmatched entries.

Step 10 - Sync back to Hubspot

Click Sync and choose the Factori fields you want to push to HubSpot.

New properties will be created in HubSpot and existing data will never be overwritten.


Step 11 -Disconnect HubSpot

To disconnect HubSpot, navigate to Settings > Integrations > Configure > Authentication and click Disconnect to remove the connection.