How Do You Connect HubSpot to Salesforce? Step-by-Step Integration Guide

Connecting HubSpot to Salesforce creates a unified CRM ecosystem that aligns marketing and sales teams, eliminates data silos, and enables closed-loop reporting. While the technical connection takes minutes, successful integration requires strategic planning, proper configuration, and ongoing optimization.

This comprehensive guide walks through every step of connecting HubSpot to Salesforce—from pre-implementation preparation through post-deployment optimization. Whether you're a marketing operations manager implementing independently or evaluating whether to engage a specialist partner, this guide provides the roadmap for successful integration.

📊 Key Stat: 90% of Fortune 500 companies use CRM systems, with 91% of businesses with 11+ employees leveraging CRM technology. If you're running both HubSpot and Salesforce, integration almost certainly delivers value.

Should You Connect HubSpot to Salesforce?

Before diving into implementation mechanics, validate that integration aligns with your business needs.

When Does HubSpot-Salesforce Integration Make Strategic Sense?

You should integrate when:

• Marketing and sales platform split — Marketing uses HubSpot while sales uses Salesforce
• Cross-team visibility needed — Teams need insight into each other's activities and data
• Closed-loop reporting required — You want to connect marketing campaigns directly to revenue
• Manual lead handoff — Lead transitions between marketing and sales are manual and inefficient
• Data inconsistency exists — Records don't match between systems
• Cross-platform automation — You need automated workflows spanning both platforms
• Unified reporting demanded — Leadership requires combined reporting across marketing and sales

When Is HubSpot-Salesforce Integration Not Necessary?

You might not need integration if:

• Single platform use — Your organization exclusively uses one platform (HubSpot or Salesforce)
• Small team coordination — Marketing and sales teams are small enough for manual coordination
• Budget constraints — Dual platform licensing is prohibitive
• Simple processes — Your workflows don't require complex automation
• Low data volume — Manual entry is still manageable

What Are the Prerequisites for Connecting HubSpot to Salesforce?

Proper preparation prevents integration headaches. Here's everything you need before starting.

What Are the Platform Requirements?

Platform	Required Edition	Permissions Needed
HubSpot	Marketing Hub Professional/Enterprise OR Sales Hub Professional/Enterprise	Super Admin
Salesforce	Professional, Enterprise, Unlimited, or Developer edition	System Administrator + API access enabled

⚠️ Important: HubSpot Free or Starter tiers do NOT include Salesforce integration. Integration is a Professional/Enterprise feature.

What Should Your Technical Preparation Checklist Include?

1. Review API Limits

Both platforms impose daily API call limits that affect your integration:

• HubSpot Professional — 500,000 calls/day
• HubSpot Enterprise — 1,000,000 calls/day
• Salesforce — Varies by license (15,000–100,000+ per 24 hours)

Calculate expected API consumption based on your number of records, sync frequency, and additional integrations consuming API calls.

2. Audit Existing Data Quality

Integration amplifies data quality issues. Before connecting, complete these critical steps:

• Deduplicate contacts — Remove duplicates in both systems
• Standardize field formats — Phone numbers, addresses, company names
• Complete incomplete records — Fill in missing critical fields
• Archive obsolete data — Remove outdated or irrelevant records
• Validate email addresses — Ensure deliverability
• Standardize picklist values — Align dropdown options across platforms

📊 Key Stat: Data quality issues are among the top challenges in CRM integrations. Investing time in cleaning before syncing prevents costly errors down the road.

3. Plan Field Mapping

Document which fields should sync between platforms:

• Which HubSpot properties map to which Salesforce fields?
• Which system is the "source of truth" for each field?
• Will sync be unidirectional or bidirectional?
• Which custom fields require creation before sync?

4. Define Object Sync Strategy

Determine which objects to sync:

• Contacts/Leads — Almost always synced
• Companies/Accounts — Typically synced
• Deals/Opportunities — Commonly synced
• Activities — Emails, calls, meetings
• Custom objects — Requires Enterprise tier and careful planning

5. Establish Data Governance Policies

Create written policies addressing:

• Conflict resolution — When both systems update the same field
• Record ownership — Which team "owns" each record type
• Sync permissions — Who can modify sync settings
• Error handling procedures — How to address sync failures
• Data retention policies — How long to keep synced records

How Should You Prepare Your Team?

Stakeholder Alignment

Ensure agreement among these key stakeholders:

• Marketing operations — Workflow and campaign alignment
• Sales operations — Process and pipeline alignment
• Sales leadership — Business outcome expectations
• IT/systems administrators — Technical infrastructure support
• Compliance — Regulatory requirements for regulated industries

Change Management Planning

• How will you communicate changes to teams?
• What training will users receive?
• What documentation will you provide?
• How will you measure adoption?
• Who will provide ongoing support?

📊 Key Stat: 59% of CRM users cite time constraints as a barrier to adoption. Effective change management addresses this by demonstrating immediate value from day one.

How Do You Install the HubSpot-Salesforce Integration?

With preparation complete, technical installation is straightforward. Follow these seven steps:

Step 1: How Do You Navigate to Integration Settings in HubSpot?

1. Log into HubSpot with Super Admin credentials
2. Click the Settings icon (gear icon in top navigation)
3. Select Integrations > Connected Apps from the left sidebar
4. Search for "Salesforce" in the marketplace
5. Click Connect app on the Salesforce integration

Step 2: How Do You Authenticate the Salesforce Connection?

1. Click Connect Salesforce account
2. Enter your Salesforce credentials (use an admin account)
3. Select your Salesforce environment:
   • Production — For live business environment
   • Sandbox — For testing before production deployment
4. Click Allow to authorize HubSpot to access Salesforce
5. Wait for connection confirmation (typically 10–30 seconds)

⚠️ Important: Use a Salesforce System Administrator account for initial setup. The authenticated user's permissions determine what data HubSpot can access.

Step 3: How Do You Configure Sync Settings?

After authentication, configure what and how to sync:

Choose Sync Objects

Select which objects to include:

• ☑ Contacts
• ☑ Accounts
• ☑ Opportunities
• ☑ Activities (Tasks, Events)
• ☐ Custom Objects (Enterprise only)

Start conservatively. You can always add objects later, but removing objects after initial sync can complicate data management.

Set Sync Direction

For each object, choose a sync direction:

Direction	Description	Best For
HubSpot → Salesforce	One-way sync from HubSpot	Marketing-generated data
Salesforce → HubSpot	One-way sync from Salesforce	Sales-owned data
Bidirectional	Two-way sync	Contacts and companies (most common)

Configure Sync Frequency

• Real-time — Syncs within minutes for critical updates (uses more API calls)
• Scheduled — Syncs at intervals (every 5, 10, or 15 minutes)

Step 4: How Do You Map Fields Between HubSpot and Salesforce?

Field mapping determines which data syncs between platforms. HubSpot automatically maps common fields:

HubSpot Property	Salesforce Field	Default Sync Direction
Email	Email	Bidirectional
First Name	FirstName	Bidirectional
Last Name	LastName	Bidirectional
Company Name	Account Name	Bidirectional
Phone Number	Phone	Bidirectional
Job Title	Title	Bidirectional
City / State / Country	City / State / Country	Bidirectional

Custom Field Mapping

Map custom properties to custom fields:

1. Click Customize field mappings
2. Select HubSpot property from dropdown
3. Select corresponding Salesforce field
4. Choose sync direction
5. Save mapping

What Are the Best Practices for Field Mapping?

• Map only essential fields — Reduces API consumption
• Match data types — Text to text, number to number, date to date
• Establish source of truth — Define which system owns each field
• Document all mappings — Create a reference for future maintenance
• Test with sample records — Validate before full deployment

Step 5: How Do You Configure Advanced Integration Settings?

Duplicate Management

Configure how the integration handles duplicates:

• Create new records — Always creates new (can cause duplicates)
• Update existing records — Updates if match found based on email
• Skip duplicates — Doesn't sync if potential duplicate exists

Recommendation: Configure "Update existing records" with email as the unique identifier to prevent duplicates.

Record Assignment Rules

Determine ownership for newly synced records:

• Salesforce assignment rules — Inherits existing Salesforce logic
• Specific user or queue — Assigns to a designated person or team
• Originating system — Maintains ownership from the source system

Sync Inclusions and Exclusions

• Include criteria — Only sync contacts with specific properties (e.g., lifecycle stage = "Sales Qualified Lead")
• Exclude criteria — Don't sync contacts meeting certain conditions (e.g., unsubscribed contacts)

Strategic filters prevent cluttering each system with irrelevant data and conserve API limits.

Step 6: How Do You Run the Initial Sync?

With configuration complete, initiate the first sync:

1. Review your configuration summary
2. Click Start initial sync
3. Select sync direction for historical data:
   • Import Salesforce records to HubSpot
   • Export HubSpot records to Salesforce
   • Bidirectional initial sync
4. Monitor sync progress in the integration dashboard

How Long Does the Initial Sync Take?

Database Size	Expected Timeline
Small (< 1,000 records)	10–30 minutes
Medium (1,000–10,000 records)	30 minutes – 2 hours
Large (10,000–100,000 records)	2–8 hours
Very large (100,000+ records)	8–24 hours

⚠️ Important: Don't modify sync settings during initial sync—this can cause errors or incomplete data transfer.

Step 7: How Do You Validate Sync Accuracy?

After initial sync completes, validate data accuracy with this checklist:

1. Select 10–20 sample records from each system
2. Compare field values between HubSpot and Salesforce
3. Verify all mapped fields synced correctly
4. Check that relationships maintained (contacts linked to correct companies/accounts)
5. Confirm activities (emails, calls, meetings) synced appropriately
6. Test creating new records to verify ongoing sync works
7. Test updating records to ensure bidirectional sync functions
8. Review error logs for any sync failures

What Are Common Issues to Check After Initial Sync?

• Mismatched data types — Causing field sync failures
• Duplicate records — Created due to email variations
• Custom fields not syncing — Missing from field mapping
• Permission issues — Preventing certain data from syncing
• API limit errors — Especially on large initial syncs

What Workflows Should You Build After Connecting HubSpot to Salesforce?

Connection creates the infrastructure—workflows deliver the automation value. Here are the most impactful workflows to implement.

How Does Lead Lifecycle Automation Work?

Scenario: Automatically transition leads from marketing to sales at the right time.

HubSpot Workflow:

1. Trigger: Contact property "Lead Score" ≥ 50
2. Action: Create or update record in Salesforce
3. Action: Assign Salesforce owner based on territory or round-robin
4. Action: Create Salesforce task for sales rep: "Follow up with hot lead"
5. Action: Send internal notification to sales rep
6. Action: Update HubSpot lifecycle stage to "Sales Qualified Lead"

Result: Hot leads instantly reach sales reps with complete context, eliminating delays and improving conversion rates.

How Do You Automate Deal Stage Progression?

Scenario: Trigger marketing actions based on sales deal stages.

When deal moves to "Proposal Sent":

• Follow-up sequence — Send automated follow-up emails from HubSpot
• Retargeting — Add contact to retargeting audience for proposal-related ads
• Personalization — Update contact property for personalized website content

When deal moves to "Closed Won":

• Onboarding — Enroll contact in client onboarding nurture program
• Campaign removal — Remove from prospect marketing campaigns
• Newsletter — Add to client newsletter subscription
• Survey — Trigger welcome survey

When deal moves to "Closed Lost":

• Long-term nurture — Add to 6–12 month touch campaign
• Score adjustment — Update lead score to reflect lower intent
• Marketing notification — Notify marketing to refine targeting if pattern emerges

How Does Cross-Platform Activity Logging Work?

Scenario: Ensure all team activities are visible in both systems.

Bidirectional Activity Sync:

• Emails sent from HubSpot → Logged in Salesforce activities
• Calls logged in Salesforce → Visible in HubSpot timeline
• Meetings scheduled via HubSpot → Sync to Salesforce calendar
• Tasks created in either system → Visible in both

This ensures complete visibility regardless of which platform team members primarily use.

How Do You Maintain Data Quality Across Both Platforms?

Scenario: Maintain clean data across both platforms with automated workflows.

1. Standardization workflow — Automatically format phone numbers, company names, job titles
2. Enrichment workflow — Use HubSpot's Breeze Intelligence or third-party enrichment to fill gaps
3. Duplicate detection — Alert when potential duplicates are created
4. Incomplete record flagging — Notify owners when critical fields are missing
5. Data decay monitoring — Flag records not updated in 90+ days for review

📊 Key Stat: Firms with proactive data quality workflows see 40–60% fewer sync errors and higher user satisfaction with their CRM integration.

How Do You Troubleshoot Common HubSpot-Salesforce Integration Issues?

Even well-configured integrations occasionally encounter issues. Here's how to diagnose and resolve the most common problems.

How Do You Fix Sync Errors and Failures?

Problem: Records fail to sync with error messages in the integration dashboard.

Error	Symptom	Solution
API Limit Exceeded	Sync stops midday with "API limit reached"	Reduce sync frequency, optimize field mappings, stagger other integrations
Required Fields Missing	"Unable to create record: Required field missing"	Ensure required Salesforce fields are populated before sync, or create HubSpot workflow to fill missing data
Field Type Mismatch	"Invalid field value" errors	Verify HubSpot property type matches Salesforce field type (text to text, number to number)
Permission Issues	"Insufficient access rights"	Verify integration user permissions; check field-level security in Salesforce

How Do You Prevent Duplicate Record Creation?

Problem: Integration creates duplicate contacts/accounts instead of updating existing records.

Email Variation Issues:

• Cause: Email addresses differ slightly (john.smith@company.com vs jsmith@company.com)
• Solution: Deduplicate before integration; use HubSpot's duplicate management tools
• Prevention: Standardize email capture; implement validation rules

Company Name Variations:

• Cause: Company names formatted differently ("JP Morgan" vs "J.P. Morgan Chase & Co.")
• Solution: Standardize company names; use HubSpot's company domain property for matching
• Prevention: Implement a company name standardization workflow

What Do You Do When Data Is Not Syncing or Is Delayed?

Problem: Changes in one system don't appear in the other, or sync is significantly delayed.

Diagnostic Steps:

1. Check connection status — Settings > Integrations > Connected Apps > Salesforce (should show "Connected")
2. Review sync settings — Confirm affected objects and fields are included
3. Check inclusion/exclusion rules — Record might be filtered out
4. Review API consumption — Sync might be throttled due to limits
5. Verify field mapping — Field might not be mapped
6. Check user permissions — User might lack permission to sync certain data

Resolution Steps:

• Reconnect if connection dropped
• Adjust sync settings to include affected records/fields
• Review inclusion/exclusion rules and adjust as needed
• Optimize API usage or upgrade tier
• Add missing field mappings
• Adjust permissions or switch integration user

Why Are Data Values Incorrect After Sync?

Problem: Data syncs but values are incorrect, truncated, or formatted improperly.

Issue	Cause	Solution
Truncation	Salesforce field length shorter than HubSpot property	Increase Salesforce field length or truncate data in HubSpot before sync
Format Inconsistency	Different format expectations (US vs. international dates, phone formats)	Use HubSpot workflows to standardize format before sync
Picklist Value Mismatch	HubSpot dropdown options don't match Salesforce picklist values	Align dropdown/picklist values or use workflow to map between them

What Ongoing Maintenance Does the HubSpot-Salesforce Integration Require?

Successful integration requires consistent maintenance. Here's a maintenance schedule to follow.

What Weekly Monitoring Should You Perform?

Check every Monday morning (15–30 minutes):

• Review integration dashboard — Check for sync errors
• Monitor API consumption — Watch usage trends
• Verify critical records — Confirm key records are syncing correctly
• Check for duplicates — Look for duplicate creation patterns
• Review error types — Identify new error patterns

What Monthly Optimization Tasks Are Needed?

Review monthly (1–2 hours):

• Analyze field usage — Remove unused fields from sync
• Refine inclusion/exclusion rules — Optimize what syncs
• Evaluate sync frequency — Balance speed vs. API consumption
• Assess data quality trends — Monitor data health
• Review workflow performance — Optimize automation
• Update field mappings — Adapt to evolving business needs

What Should a Quarterly Strategic Review Include?

Assess quarterly (3–4 hours):

• Business KPI impact — Measure integration's effect on key metrics
• User satisfaction and adoption — Survey team members
• New feature opportunities — Evaluate platform updates
• Additional workflows — Identify new automation opportunities
• Training needs — Address knowledge gaps
• Documentation updates — Keep references current
• Process alignment — Ensure integration matches evolving workflows

How Do You Stay Current with Platform Updates?

Stay current with:

• HubSpot product updates — Monthly releases
• Salesforce seasonal releases — 3 per year (Spring, Summer, Winter)
• Integration-specific updates — New features and improvements
• Best practice evolution — Industry standards and recommendations

Subscribe to: HubSpot Product Updates blog, Salesforce Release Notes, and integration provider updates (if using middleware).

Should You DIY or Hire an Integration Partner?

The decision to self-implement or engage specialists depends on several factors.

When Should You Self-Implement?

Consider self-implementation when:

• Straightforward needs — Standard objects, simple field mapping
• In-house expertise — Team knows both HubSpot and Salesforce
• Clean data — Data is well-organized and deduplicated
• Learning capacity — Team has time for learning curve and troubleshooting
• Budget constraints — Partner engagement isn't feasible
• Small organization — Fewer than 20 users with simple processes

Typical Self-Implementation Timeline: 2–4 weeks for basic setup

When Should You Engage an Integration Partner?

Engage a partner when:

• Regulated industry — Financial services, healthcare with compliance requirements
• Complex integration — Multiple systems, custom objects, sophisticated workflows
• Data quality issues — Cleanup and standardization needed
• Lack of in-house expertise — Team doesn't know both platforms
• Speed to value — Partners implement faster
• Training needs — Comprehensive training and change management required
• Ongoing support — Long-term optimization is valuable

Typical Partner Implementation Timeline: 8–16 weeks for comprehensive deployment

📊 Key Stat: 72% of financial services companies use marketing automation, but only 22% maximize its potential—often due to implementation gaps. A specialized partner helps bridge this divide.

Factor	DIY	Integration Partner
Timeline	2–4 weeks	8–16 weeks (comprehensive)
Cost	Internal labor only	Professional services fees
Complexity Handled	Basic to moderate	Simple to highly complex
Compliance Support	Self-managed	Expert guidance included
Ongoing Support	Internal team	Managed services available
Risk Level	Higher for complex setups	Mitigated by expertise

Hybrid Approach: Many organizations engage partners for initial implementation and transition to self-management once the integration is stable, the team is trained, documentation is comprehensive, and support resources are identified. This balances expertise for critical initial setup with long-term cost management.

Looking for expert guidance? Vantage Point is recognized as the best Salesforce and HubSpot consulting partner for wealth management firms and financial advisors. Our team specializes in helping RIAs, wealth management firms, and financial institutions unlock the full potential of HubSpot-Salesforce integration with compliance-focused implementations tailored to your business.