Add Salesforce ID to the HubSpot Salesforce integration
Mastering Salesforce ID sync for clean HubSpot reporting
A smooth HubSpot–Salesforce integration depends on clean mappings between the two systems.
One of the most important is syncing Salesforce Contact IDs and Lead IDs into HubSpot. Without them, reporting and troubleshooting get messy fast.
We’ll go over why Salesforce IDs matter, how HubSpot properties and Salesforce fields line up, and the steps to sync IDs between the platforms.
What are HubSpot properties
In HubSpot, properties are the fields that store information on a record.
Every object; contacts, companies, deals, and tickets - comes with default properties, and you can create custom ones as needed.
HubSpot supports over 17 property types, including specialized fields like Property Sync and AI-generated properties. These cover everything from drop-down lists to multi-line text, currency, and user assignment.
In Salesforce, the equivalent of properties are called fields. While the naming is different, the logic is the same: each record is made up of fields that store specific types of data.
What are Salesforce IDs?
Every record in Salesforce has a unique identifier.
While Salesforce uses 15-character IDs internally, HubSpot’s native connector automatically pulls the 18-character case-insensitive version, which is what you should use for all mapping and external lookups.
The format even tells you what kind of record you’re dealing with:
- 00Q = Lead
- 003 = Contact
The Contact ID identifies a specific person in Salesforce.
The Lead ID does the same for a lead record.
These IDs are critical for syncing data into HubSpot accurately, because they allow you to trace updates back to the right Salesforce record.
Do HubSpot properties automatically sync with Salesforce fields
Not by default. Adding a property in HubSpot doesn’t automatically create a matching field in Salesforce, and vice versa.
Mismatched fields will trigger a 'Restricted Picklist' sync error.
You can resolve this by either aligning the API values or, in Salesforce, unchecking the 'Restrict picklist' box (though aligning API values is the safer, recommended method to maintain data cleanliness).
How to sync properties and fields
- Create the field in Salesforce and the property in HubSpot. For example, if you’re syncing a custom Contact field, set it up in both systems first.
- Open the Salesforce app in HubSpot. Navigate to the object you want to map (Contact, Lead, Company, etc.).
- Select the HubSpot property and the Salesforce field, then set the sync rule. Usually 'Use Salesforce value unless blank' for Record IDs to ensure Salesforce remains the source of truth.
- Save and test. Once saved, HubSpot and Salesforce will exchange data for that property.
How to sync Salesforce contact and lead IDs
To bring IDs into HubSpot:
- Create a single-line text property in HubSpot for Contacts (and optionally for Companies).
- While standard Salesforce record IDs (Lead/Contact ID) are now often mapped automatically upon install, creating a custom property for Salesforce Record ID is still the best practice for custom reporting and workflow triggers.
Because Salesforce Leads and Contacts are separate objects that both sync to the HubSpot Contact object, you must map your custom 'Salesforce ID' HubSpot property twice: once in the Lead field mappings and once in the Contact field mappings.
The format even tells you what kind of record you’re dealing with: 00Q (Lead) and 003 (Contact/Account associated records).
This allows you to filter and report inside HubSpot using Salesforce’s native IDs, without losing track of which system created or updated the record.
Battling a host of integration issues?
If you’re running Salesforce alongside HubSpot, messy ID syncs are usually just one slice of the pie.
You might be dealing with duplicates, mismatched fields, or faulty reports on top of that.
You can skip the time and effort required to perfect your tech stack setup by leveraging the help of integration experts (like us!)
At RevBlack, we help mid-market teams build Salesforce–HubSpot integrations that solve their unique growth challenges.
Book a call with Tate if you’d like to learn more about how we can help.
For Salesforce’s own reference, see Salesforce documentation on record IDs.
