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 14 property types, from simple text fields to complex scoring and calculation 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.
screenshot: HubSpot property creation screen with field type options.
What are Salesforce IDs?
Every record in Salesforce has a unique identifier, a 15- or 18-character ID.
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.
If you try to sync mismatched fields, Salesforce will throw an error, often because HubSpot is sending a value that doesn’t exist in the Salesforce picklist.
That’s why you need to create matching fields in Salesforce and properties in HubSpot and ensure their API values line up.
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.).
- Create a new field mapping. Select the HubSpot property and the Salesforce field, then set the sync rule.
- 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).
- Map the Salesforce Contact ID and Lead ID fields to this property.
Both IDs will sync into the same HubSpot property, because Salesforce uses “ID” as the API name. You can tell them apart by their prefixes: 003 for Contacts and 00Q for Leads.
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.
