Overview
Cross-system linking connects the same customer across different integrations. For example, link a HubSpot company to a Salesforce account so data from both systems appears on a single customer profile.How It Works
When you have multiple integrations connected (e.g., Salesforce as primary CRM and HubSpot for marketing), you can link records between them using ID fields that exist in both systems. Two linking modes:| Mode | Use when |
|---|---|
| Primary has ID | Your primary system stores the secondary system’s ID (e.g., Salesforce has a “HubSpot ID” field) |
| Secondary has ID | Your secondary system stores the primary system’s ID (e.g., HubSpot has a “Salesforce ID” field) |
Configuring Cross-System Linking
1
Go to Customer Object Settings
Navigate to Settings → Objects → Customers → Configuration tab
2
Scroll to Cross-System Linking
Find the “Cross-System Linking” section below field mappings
3
Select Secondary System
Choose which secondary integration you want to link (lists all connected integrations except your primary)
4
Choose Linking Mode
Select how the systems are linked:Primary has ID: Select the field in your primary system that contains the secondary system’s IDSecondary has ID: Select the field in your secondary system that contains the primary system’s ID
5
Save
Click Save. Records will be linked on the next sync.
Example
Setup: Salesforce (primary) and HubSpot (secondary) Scenario: Your HubSpot company records have a custom property calledsalesforce_account_id that stores the Salesforce Account ID.
Configuration:
- Select HubSpot as secondary system
- Choose Secondary has ID
- Select
salesforce_account_idfrom the HubSpot fields - Save
Status Indicators
| Status | Meaning |
|---|---|
| Linked | Cross-system linking is configured |
| Not linked | No linking configured for this integration |

