Find answers and general information quickly about the HubSpot-Salesforce integration.
For quick answers about version 3.0 of the connector package, refer to this article: HubSpot-Salesforce Connector Package v3.0 | Frequently Asked Questions.
- Does the HubSpot-Salesforce integration support Salesforce Government Cloud?
- Does the HubSpot-Salesforce integration support Salesforce Group Edition?
- Can I integrate multiple HubSpot accounts with one Salesforce environment?
- Which HubSpot contacts will sync to Salesforce?
- Can Salesforce person accounts sync to HubSpot?
- Why are HubSpot activities creating duplicate Salesforce tasks?
- Why doesn't the Lifecycle stage property appear in Salesforce?
- Why is a contact's Company name property not syncing with Salesforce?
- Does email opt-out status sync between HubSpot and Salesforce?
- Will Closed/Won opportunities on Salesforce accounts convert HubSpot contacts to customers?
Yes, the HubSpot-Salesforce integration supports and can connect to Salesforce Government Cloud.
No, the HubSpot-Salesforce integration does not support Salesforce Group Edition. The integration supports Salesforce editions with API access and Salesforce Professional.
If your HubSpot-Salesforce connector is version 2.60 or above, you can integrate two HubSpot accounts with one Salesforce environment. If you already have one HubSpot account integrated with your Salesforce environment, you can take the same steps to install the Salesforce integration in your second HubSpot account.
Please note: for the Creating contacts in HubSpot setting for Salesforce leads and contacts, it's recommended to select Don't automatically create HubSpot contacts. If either of the other options are selected, contacts or leads created in Salesforce in one HubSpot account may be created in the other HubSpot account.
All HubSpot contacts will sync to Salesforce by default. However, if you create an inclusion list in HubSpot, only contacts that meet the criteria of your inclusion list will sync to Salesforce.
On June 22, 2017, default inclusion lists were created for all Salesforce-integrated HubSpot accounts which did not have an inclusion list. The list is named Salesforce inclusion list (default), and includes all contacts, except those with a Lifecycle stage of Subscriber. HubSpot accounts created or integrated with Salesforce after June 22, 2017 will not have an inclusion list by default, and all contacts will sync to Salesforce.
Yes, it is possible to sync person accounts in Salesforce to HubSpot. Unlike business accounts, person accounts cannot have associated contacts in Salesforce. Instead, they use a specific record type ID to store both an account and contact on the same layout.
When a person account is created, Salesforce also creates a contact in the background. While the contact is not directly visible in Salesforce, HubSpot creates a unique company and contact record when person accounts are enabled (if Salesforce is set to create contacts in HubSpot and account sync is enabled).
HubSpot cannot create person accounts in Salesforce when new contacts are created in HubSpot. If HubSpot is set to create new leads in Salesforce when new contacts are created in HubSpot, the new lead can be converted into a person account in Salesforce as long as it has no value for the Company field. Leads that have a value in the Company field are converted to business accounts.
Every time a contact opens or clicks a marketing email sent from your HubSpot account, HubSpot deduplicates each type of activity on the object record timeline. If you have set up these email activities to sync to Salesforce, the corresponding Salesforce tasks are created via HubSpot's Email Events API, which does not deduplicate activities.
- If a contact opens or clicks a marketing email multiple times, multiple Salesforce tasks will be created.
- If a contact forwards a marketing email to another recipient, any subsequent email opens and clicks will be attributed to the original contact, and more Salesforce tasks will be created.
Lifecycle stage is a default HubSpot contact property that does not exist in Salesforce. To sync lifecycle stage data to Salesforce, create a custom field in Salesforce, then create a field mapping in HubSpot.
If a contact's Company name property is not syncing between HubSpot and Salesforce, it may be because the HubSpot contact is syncing with a Salesforce contact, rather than a Salesforce lead.
- Salesforce leads have a Company Name text field.
- Salesforce contacts have an Account Name reference field linked to the associated account record.
Because Company Name and Account Name are different field types, they cannot sync with the same property in HubSpot. In addition, because Account Name is a reference field, its value cannot sync with the HubSpot property Company name, which is a single-line text field type.
If a HubSpot contact syncs with a Salesforce contact, the HubSpot property Company name will not sync with Salesforce. However, if account sync is enabled, the Salesforce contact's associated account will sync with the corresponding HubSpot contact's associated company. These associated company properties can be used in HubSpot list and CRM filters, workflows, and content personalization.
Yes. When the HubSpot-Salesforce integration is installed, a standard field mapping is automatically created that syncs the HubSpot contact property Opted out of all email and the Salesforce lead/contact field Email Opt Out. This field mapping cannot be modified or deleted in compliance with CAN-SPAM laws.
- When a contact is opted out of email communication in your HubSpot account, or the Email Opt Out checkbox is selected on their Salesforce lead or contact record, the other system will be updated.
- If a contact is already opted out of email communication in your HubSpot account, clearing the Email Opt Out checkbox on their Salesforce lead or contact record will not resubscribe them to email communication. They must take action themselves in order to receive marketing emails sent from your HubSpot account again.
- If a contact is not currently syncing between HubSpot and Salesforce (e.g., they are not in your Salesforce inclusion list, if there is one set up), the email opt-out status will not pass from either system until the first time the contact syncs.
If you have set up Salesforce accounts to sync to HubSpot and
With the HubSpot Account Sync enabled, Salesforce integrated HubSpot users' default settings can be adjusted so that all contacts connected to one Salesforce Account will have the same Lifecycle Stage.
To find this setting:
- Navigate in HubSpot Marketing to Contacts > Contacts Settings. Select Contacts & Companies from the left-side menu.
- Scroll to the Companies section and turn the toggle ON beside Lifecycle stage sync in order to sync the company lifecycle stage to contacts.
With Automatic Lifecycle Stage Transitions enabled, when a contact in Salesforce is attached to a Salesforce Opportunity, it will change the Lifecycle Stage of the contact in HubSpot to Opportunity. If a Salesforce Opportunity is then marked as Closed/Won, the contact's Lifecycle Stage will be changed to Customer.
Please note that in order for the Automatic Lifecycle Stage Transitions to work, at least one Contact in the Salesforce Account must be attached to the Contact Roles related list of the Salesforce Opportunity. An Opportunity in Salesforce with an Account attached, but no contacts, will have no effect in HubSpot. Read more about Automatic Lifecycle Stage Transitions here.
HubSpot identifies Salesforce Standard, PowerPartner, Guest, and Queue users as Salesforce owners when:
- They are imported into HubSpot from Salesforce.
- The Salesforce user owns a lead, contact, account, or opportunity record that syncs to HubSpot.
By default, the Owner ID field on a Salesforce lead, contact, account, or opportunity record will sync to the HubSpot Contact/company/deal owner property.
Any Salesforce owner can sync to HubSpot, but only owners in HubSpot that match an active Salesforce user's name and email address will sync to Salesforce. If HubSpot attempts to sync an owner that doesn't exist in Salesforce, the Owner ID field will reset to the last value from Salesforce.
Learn more about how Salesforce owners are assigned to HubSpot contacts, companies, or deals that sync to Salesforce.