Follow these instructions to map HubSpot contact properties to Salesforce lead or contact fields.
Go to IntegrationsIn your HubSpot Marketing Professional or Enterprise account or in your Sales Professional account, click your photo or avatar in the top right-hand corner, then click Integrations.
Salesforce settingsUnder the Your integrations tab, locate Salesforce and then click Settings to the right of it.
In the example below, Salesforce has a custom field that hasn’t been created in HubSpot yet. The instructions below walk through the process of mapping an existing Salesforce property to a new property in HubSpot.
Manage your contact mappings
Select the General tab. Scroll to the Sync Settings section, and in the CRM Objects table, select Manage mappings in the Contacts row.
If you are trying to map account fields to HubSpot, then choose Manage mappings in the Companies row. Please note that account sync must be enabled.
Add new field mapping
Click Add new field mapping so you can set up a new mapping between a Salesforce record and a HubSpot property.
Create new HubSpot property
Next, choose the radio select button next to Create New HubSpot Property, and in the text field below it, type in the name for your new HubSpot property. In this example, we'll name it to match the existing Salesforce field we’re about to map to, Other Phone.
What Salesforce field would you like to map it to?
Now that you’ve created a new HubSpot property, you’ll need to select the dropdown menu for What Salesforce field would you like to map it to? and search for the existing field in Salesforce you want to map your new HubSpot property to. If you haven’t yet created your custom field in Salesforce, check out this Salesforce article.
When should HubSpot data update the corresponding Salesforce field?
Finally, decide when data should be passed between the Salesforce field and the HubSpot property you’re mapping. You have four choices:
- Use most recent value, I want the most recent data from either system to populate that field. Example: changes in email address will always be updated in both systems when there’s a change, so you always have the most current email.
- Use Salesforce value unless blank, if Salesforce already has the data, leave it untouched. Example: maybe you have a field strictly about a person or company's budget. This information may be more helpful for your sales team than your marketing team.
- Use Salesforce value, I only want Salesforce data to update the HubSpot property. Example: if there’s a field that your sales reps use and need to remain the same in Salesforce constantly, this is a wise choice, like account or company details.
- Disabled -- do not update value, data will not pass between these fields. This should be used for any fields that you want to temporarily pause the sync for between Salesforce and HubSpot. This is often useful if you’re trying to disable a mapping for testing purposes.
In our example, we want data to pass between these two fields any time there’s any sort of change in Salesforce or HubSpot, so we’ll choose the radio select button next to Use most recent value, I want the most recent data from either system to populate that field.
Click Save Mapping when you're done setting up your mapping.
Alternatively, you can click Save and Create New if you’d like to save the mapping you've just created and automatically go back into creating another mapping. This is wise if you have a lot of mappings you need to set up, as it can speed up the process.
You should now see the new field mapping listed that connects your Salesforce field and your HubSpot property.
Remember, this is the same process if you already have an existing HubSpot property. Just choose the Choose Existing HubSpot Property option in step 5 and then proceed to the next steps listed above.
You’ve now successfully set up a mapping between a Salesforce field and a HubSpot property.