The HubSpot-Salesforce integration is one of the most-used in both platforms' ecosystems - and one of the most frequently misconfigured. Done correctly, it gives marketing teams visibility into which campaigns sourced closed revenue, and gives sales teams visibility into which leads are marketing-engaged before they pick up the phone. Done incorrectly, it creates duplicate contacts, overwrites clean data, and erodes trust between marketing and sales.
If you are still deciding whether HubSpot or Salesforce should be your primary CRM, read our HubSpot vs Salesforce comparison first. This guide covers the full setup from prerequisites through advanced workflows, with field mapping reference tables, sync configuration decisions, troubleshooting for the most common errors, and governance practices for keeping the integration clean over time.
Benefits of the HubSpot-Salesforce integration
• Single contact record across systems. A lead that engages with marketing content in HubSpot and then converts to an opportunity in Salesforce is the same record, with the full history of both marketing and sales activity.
• Marketing attribution in Salesforce. HubSpot's original source data (organic search, paid social, email, direct) syncs to Salesforce, giving sales reps and RevOps the context of where each lead came from.
• Lead scoring visible to sales. HubSpot's contact and company scores sync to Salesforce as custom fields, so reps can prioritise outreach based on marketing engagement without leaving Salesforce.
• Sales activity visibility in HubSpot. Calls, emails, and meetings logged in Salesforce appear on the HubSpot contact timeline, giving marketing a complete picture of where each lead is in the sales process.
• Closed-loop revenue reporting. Closed won deal values in Salesforce sync back to HubSpot, enabling attribution reporting that connects marketing campaigns to revenue, not just leads.
Prerequisites and planning
Before installation, confirm:
• You have a HubSpot Professional or Enterprise account (the Salesforce integration requires a paid HubSpot plan)
• You have a Salesforce Professional, Enterprise, Unlimited, or Developer edition account
• You have a Salesforce System Administrator account or one with the required permissions (HubSpot's Salesforce integration requirements: knowledge.hubspot.com/crm-integrations/connect-hubspot-and-salesforce)
• You have identified the HubSpot admin and Salesforce admin who will jointly own the integration configuration
• You have a documented list of which fields should sync in which direction
The most important pre-installation planning decision is contact inclusion: which HubSpot contacts should sync to Salesforce? Syncing all contacts clutters Salesforce with every newsletter subscriber. A well-defined inclusion list (contacts who reach a specific lifecycle stage, submit a specific form, or meet a lead score threshold) keeps Salesforce clean and focused on sales-ready leads.
Step-by-step installation and configuration
Installing the HubSpot Salesforce app
1. Install the Salesforce package from HubSpot. In HubSpot: Settings > Integrations > Salesforce. Click 'Connect to Salesforce'. This installs the HubSpot managed package in Salesforce and adds custom fields to Salesforce lead and contact records.
2. Authenticate the connection. Log in to Salesforce using your Salesforce admin credentials when prompted. Grant the permissions requested by the HubSpot managed package.
3. Configure the contact inclusion list. Define which HubSpot contacts sync to Salesforce. The default is all contacts. Narrow this to a specific list (e.g., 'Lifecycle Stage is MQL or later') before enabling sync.
4. Run the initial sync. HubSpot will prompt you to run an initial sync for existing contacts. For large databases, do this during off-peak hours. Monitor the sync log for errors.
Sync settings and object mapping
Sync settings reference: HubSpot Salesforce integration documentation, knowledge.hubspot.com/crm-integrations/connect-hubspot-and-salesforce (verified June 2026).
Field mapping reference
Map fields explicitly rather than relying on defaults. HubSpot's default field mapping covers the basics but misses custom properties that are critical for most B2B teams.
Add custom field mappings for any HubSpot custom properties that sales reps need visibility on, and any Salesforce fields that marketing needs for segmentation. Keep the bidirectional field list as short as possible. Every bidirectional field is a potential conflict point.
Advanced revenue operations workflows
MQL to SQL handoff workflow
The most important workflow in the integration. When HubSpot marks a contact as a Marketing Qualified Lead, it should automatically sync to Salesforce and notify the assigned sales rep.
5. Enrollment trigger: Contact Lifecycle Stage = Marketing Qualified Lead
6. Action: Set HubSpot contact property 'Salesforce Sync' = True (if using an include list)
7. Delay: 5 minutes (allows sync to complete)
8. Action: Send internal email notification to contact owner with contact summary
9. Action (optional): Create Salesforce task via the integration for the assigned rep
Re-engagement of closed-lost opportunities
When a Salesforce opportunity closes as lost, the contact should re-enter a marketing nurture track in HubSpot. This requires the Salesforce opportunity stage to sync to HubSpot.
• Configure Salesforce Deal Stage to sync to a HubSpot custom contact property (e.g., 'Last SF Opportunity Stage')
• Build a HubSpot workflow with enrollment trigger: 'Last SF Opportunity Stage = Closed Lost'
• Enroll in a re-engagement sequence appropriate to the close reason (price, timing, competitor)
• Set a re-engagement date task in Salesforce for the assigned rep via the workflow
Account-based marketing with company sync
HubSpot companies sync to Salesforce accounts. For ABM programs, this enables:
• Targeting Salesforce accounts with HubSpot ad audiences (LinkedIn, Google)
• Scoring accounts in HubSpot based on engagement across all associated contacts
• Syncing HubSpot account scores to Salesforce for territory prioritisation
Configure company-to-account matching in HubSpot sync settings. Use domain-based matching as the primary key to avoid creating duplicate accounts for the same company.
Managing and troubleshooting the integration
Monitoring the integration health
• Check HubSpot's sync error log weekly (Settings > Integrations > Salesforce > Sync Errors)
• Review the Salesforce sync queue in HubSpot for any contacts stuck in pending status
• Set up a HubSpot dashboard showing sync volume, error rate, and last sync time
• Quarterly: review field mapping for any HubSpot properties that have been renamed or deleted
Troubleshooting common sync errors
Governance best practices
The integration degrades over time without governance. Common failure modes: field mappings that were correct at setup but no longer match how either team uses their CRM; sync errors that accumulate and are not reviewed; and the inclusion list never being updated to reflect changes in the qualification process.
• Assign a joint owner (RevOps or a nominated person from each team) who reviews the integration quarterly
• Document every field mapping decision and the rationale. When either team changes a field, check the integration documentation first
• Define a process for handling sync errors: who reviews them, how quickly, and who fixes them
• Test the integration after every major HubSpot or Salesforce update. Both vendors update their platforms regularly and managed packages occasionally require updates
Common use cases and ROI
Use case
How the integration enables it
Teams involved
MQL to SQL handoff
HubSpot marks contact as MQL, syncs to SF, assigns to rep via workflow
Marketing + Sales
Lead source attribution in SF
HubSpot original source data syncs to SF lead/contact record
Marketing + RevOps
Re-engagement of closed-lost deals
SF opportunity stage syncs to HubSpot, triggers re-nurture workflow
Sales + Marketing
Sales activity visibility in HubSpot
SF tasks and logged calls sync to HubSpot contact timeline
Sales + Marketing
Account-based reporting
SF account data syncs to HubSpot company record for ABM segmentation
Marketing + RevOps
Revenue attribution
Closed won deal data in SF syncs back to HubSpot for attribution reporting
RevOps + Marketing
The clearest ROI case for the integration is closed-loop attribution: marketing teams that can see which campaigns sourced closed won revenue can allocate budget more effectively. Teams without this visibility routinely over-invest in top-of-funnel channels and under-invest in the nurture sequences that convert leads to revenue.
Alternatives and complementary tools
Zapier / Make. For teams that need simple, one-directional data passing without the full HubSpot-Salesforce managed package. Appropriate for specific workflows (e.g., sync a specific HubSpot form to a Salesforce custom object) but not a replacement for the native integration for full contact and company sync.
Pandium / Coefficient. Third-party integration tools that offer more custom field mapping and sync control than the native integration. Worth evaluating for teams with complex custom object requirements that the HubSpot managed package does not support.
Revenue operations platforms (Clari, Gong). These connect to both HubSpot and Salesforce and add forecasting, conversation intelligence, and revenue analytics on top of the base integration. Not a replacement for the HubSpot-Salesforce connection, but a layer on top of it. For teams still evaluating HubSpot as a CRM, see our Pipedrive vs HubSpot comparison.
Work with Belt Creative
Configuring the HubSpot-Salesforce integration correctly the first time saves weeks of data cleanup. Belt Creative's HubSpot services team sets up and audits HubSpot integrations for B2B teams - field mapping, sync settings, workflow configuration, and governance documentation included.
See our work for examples of HubSpot integration projects, or get in touch to talk through your setup.
A note on sources
HubSpot-Salesforce integration documentation: knowledge.hubspot.com/crm-integrations/connect-hubspot-and-salesforce (verified June 2026). Salesforce editions compatibility verified at salesforce.com/editions-pricing. All feature availability and pricing subject to change; verify with official documentation before implementation.
Frequently Asked Questions
How long does it take to set up the HubSpot Salesforce integration?
Basic setup (install, authenticate, default sync enabled) takes 2-4 hours. A properly configured integration - with a defined inclusion list, custom field mapping, conflict resolution rules, and test-verified sync - takes 1-3 days. Advanced workflows (MQL handoff, closed-lost re-engagement, account-based scoring) add another 1-3 days depending on complexity.
Does the HubSpot Salesforce integration sync in real time?
Yes, by default. Most changes in HubSpot sync to Salesforce within 1-2 minutes. The initial sync of existing records may take longer depending on database size. You can configure slower sync frequencies (every 5 minutes, hourly) to reduce API call volume if needed, but real-time is the default and the right setting for most teams.
Can I sync HubSpot custom properties to Salesforce custom fields?
Yes. Create the custom field in Salesforce first (or confirm it already exists), then add the field mapping in HubSpot's sync settings. Reference the Salesforce API field name (not the display label) when configuring the mapping. Both standard and custom objects can have custom field mappings, though custom object sync requires HubSpot Enterprise.
What happens to existing contacts in both systems when the integration is first connected?
HubSpot will attempt to match existing records by email address. Matched records are merged into a single synced record. Unmatched records can be imported bidirectionally or kept separate. The initial sync should always be tested on a small subset of contacts before running on the full database. Duplicate records are the most common post-installation problem on large databases.
How do I prevent Salesforce from overwriting clean HubSpot data?
Set conflict resolution rules in HubSpot's field mapping settings. For each bidirectional field, define which system wins when both have been updated. For fields that marketing owns (lead score, lifecycle stage), set HubSpot as the winner. For fields that sales owns (deal stage, account tier), set Salesforce as the winner. Avoid bidirectional sync on fields that are genuinely owned by one team.
Can I sync HubSpot deals to Salesforce opportunities?
Yes, with HubSpot's bidirectional deal-opportunity sync available on Professional and Enterprise plans. Deals in HubSpot map to Opportunities in Salesforce. Pipeline stages, deal amounts, close dates, and associated contacts sync bidirectionally. Configure the pipeline stage mapping carefully - the names do not need to match, but the intent of each stage should align between the two systems.
How do I handle contacts that should be in HubSpot but not in Salesforce?
Use HubSpot's contact inclusion list. Only contacts that match the inclusion criteria sync to Salesforce. Contacts outside the list (early-stage nurture, newsletter subscribers, unqualified leads) stay in HubSpot only. This is the most important configuration decision for keeping Salesforce clean. Update the inclusion list whenever your qualification criteria change.
What Salesforce permissions does the integration require?
The Salesforce user account used for the HubSpot connection needs: API Enabled, Create and Edit permissions on Leads, Contacts, Accounts, and Opportunities, and View All permissions on the same objects. A dedicated integration user account (not a named sales rep account) is recommended - this prevents the integration from breaking when a rep leaves the company and their account is deactivated.
Does the integration work with Salesforce Pardot / Marketing Cloud Account Engagement?
Pardot and HubSpot are competing marketing automation platforms. If your organisation uses Salesforce as the CRM and has recently migrated from Pardot to HubSpot for marketing, the HubSpot-Salesforce integration replaces the Pardot-Salesforce connection. You cannot run both HubSpot Marketing Hub and Pardot as active marketing automation platforms syncing to the same Salesforce org without creating significant data conflicts.
How much does the HubSpot Salesforce integration cost?
The integration is included with HubSpot Professional and Enterprise plans at no additional cost. There is no Salesforce add-on fee for the HubSpot managed package. The cost is your HubSpot plan subscription. Salesforce editions from Professional upward support the integration; Salesforce Essentials does not.
Sources: HubSpot Knowledge Base (knowledge.hubspot.com/crm-integrations/connect-hubspot-and-salesforce); Salesforce editions documentation (salesforce.com); HubSpot API documentation (developers.hubspot.com). All documentation verified June 2026.
