HubSpot Salesforce Integration Guide

Overview

HubSpot and Salesforce are two of the most widely deployed customer relationship management platforms in the market. While each serves different organizational needs—HubSpot excels at inbound marketing and sales automation, while Salesforce dominates enterprise sales and service operations—many mid-market and enterprise teams use both simultaneously. The native integration between them eliminates manual data entry, prevents duplicate records, and keeps your customer information synchronized across both systems.

This guide walks you through how the integration works, what it enables, and whether it’s the right fit for your team.

How the Integration Works

• Bidirectional sync: Contact, company, and deal data flows in both directions. Updates made in HubSpot (like a new contact or updated phone number) automatically push to Salesforce, and vice versa.
• Custom object mapping: Beyond standard fields, you can map custom properties and objects so that proprietary data structures in one system reflect in the other.
• Real-time or scheduled sync: Depending on your configuration, changes can sync immediately or on a scheduled interval (typically every 15–60 minutes) to reduce API load.
• Conflict resolution: If the same field is edited in both systems simultaneously, the integration uses a defined rule (usually “last write wins” or a priority system) to determine which value persists.
• Setup via connector: The integration is managed through HubSpot’s native Salesforce connector or via third-party middleware, with authentication handled through OAuth so you don’t store credentials in plain text.

Key Features & Capabilities

• Automatic contact synchronization: New contacts created in HubSpot’s CRM are automatically added to Salesforce as leads or accounts, and vice versa. Phone numbers, email addresses, and custom fields stay in sync.
• Deal and opportunity sync: Sales deals created in HubSpot’s pipeline sync to Salesforce as opportunities, including deal value, stage, and close date. Changes to deal status in either system update the other in near real time.
• Company and account mapping: Company records in HubSpot map to accounts in Salesforce, preserving relationships and hierarchy so your account teams see the full customer picture.
• Activity logging: Calls, emails, and tasks logged in one system can be visible in the other, giving both sales and marketing teams a unified activity history.
• Duplicate prevention: The integration includes logic to identify and merge duplicate records based on email or other unique identifiers, reducing data quality issues.
• Custom field mapping: If you’ve built custom fields in either platform, you can map them so data flows between systems without manual intervention.

Setup Difficulty: Medium

Expect 30–60 minutes for initial setup, plus 1–2 hours for field mapping and testing if you have custom properties. Here’s why it’s not trivial:

• You’ll need admin access in both HubSpot and Salesforce.
• You must authenticate the connection via OAuth, which requires a few clicks but is straightforward.
• Field mapping requires you to understand which HubSpot properties correspond to which Salesforce fields. If you’ve customized either system heavily, this step takes longer.
• You should test with a small batch of records before syncing your entire database to catch any unexpected behavior.
• No code is required, but configuration knowledge of both platforms is helpful.

Common Integration Scenarios

Scenario 1: Marketing-led organization using HubSpot, sales team on Salesforce

Your marketing team nurtures leads in HubSpot and hands off qualified leads to sales. The integration automatically creates leads in Salesforce when a contact reaches a certain score or lifecycle stage in HubSpot. Sales reps can then convert those leads to accounts and opportunities in Salesforce, and those changes sync back to HubSpot so marketing can see the full funnel.

Scenario 2: Enterprise with multiple business units

One division uses HubSpot for customer success and support, while another uses Salesforce for enterprise sales. The integration ensures that when a customer is added to one system, they appear in the other, preventing duplicate outreach and ensuring consistent account information.

Scenario 3: Data consolidation during a migration

If you’re moving from HubSpot to Salesforce (or vice versa), the integration can run in parallel during a transition period, allowing both teams to work in their preferred system while data stays synchronized.

Potential Challenges & Limitations

• Field mapping complexity: If your HubSpot and Salesforce schemas differ significantly, mapping can be time-consuming. Not all custom fields may sync automatically.
• Sync latency: While near real-time, there may be a 5–15 minute delay depending on system load and your sync frequency settings.
• Data conflicts: If the same record is edited in both systems at nearly the same time, the conflict resolution rule may not always choose the value you expect. Clear workflows help prevent this.
• API rate limits: Large organizations with frequent updates may hit Salesforce API rate limits, requiring throttling or upgrade to higher API limits.
• Deactivated records: Deleting or deactivating a record in one system doesn’t always automatically delete it in the other; you may need manual cleanup.

Alternatives & Workarounds

If the native integration doesn’t meet your needs, consider these options:

• Zapier or Make (formerly Integromat): These automation platforms offer pre-built connectors for HubSpot and Salesforce. They’re useful if you need conditional logic (e.g., “sync only deals over $50,000”) or if you want to involve a third system like Slack or email. Setup is faster but may incur per-task costs at scale.
• Custom API integration: If you have development resources, you can build a custom middleware using HubSpot’s and Salesforce’s REST APIs. This gives you complete control over sync logic but requires ongoing maintenance.
• Switch to a single platform: If the integration overhead is too high, some organizations choose to standardize on either HubSpot (for smaller, marketing-forward teams) or Salesforce (for large, complex sales operations). This eliminates sync issues but requires migration effort.
• Data warehouse approach: For advanced analytics, some teams sync both HubSpot and Salesforce to a data warehouse (like Snowflake or BigQuery) rather than syncing them directly. This decouples the systems and gives you a single source of truth for reporting.

Best Practices for a Smooth Integration

• Start small: Test the integration with a subset of records (e.g., a single sales team or marketing list) before rolling out organization-wide.
• Document your field mapping: Create a spreadsheet showing which HubSpot properties map to which Salesforce fields. This is invaluable for troubleshooting and onboarding new team members.
• Establish data ownership: Decide which system is the “source of truth” for each field. For example, if email is always updated in Salesforce first, make sure HubSpot doesn’t overwrite it.
• Monitor sync health: Check integration logs regularly (both platforms provide them) to catch errors or failed syncs early.
• Clean your data before syncing: Remove duplicates and standardize formatting in both systems before enabling the integration. It’s much harder to fix afterward.
• Train your team: Make sure sales and marketing teams understand that data entered in one system will appear in the other. This prevents confusion and duplicate entry.

Frequently Asked Questions

Does the integration sync historical data?

The native integration typically syncs only new and updated records going forward. If you need to migrate historical data (e.g., all contacts and deals from the past two years), you’ll need to do an initial bulk import or use a data migration tool. Many organizations do this as a one-time setup step before enabling live sync.

What happens if I delete a record in HubSpot—does it delete in Salesforce?

By default, deleting a record in HubSpot does not automatically delete it in Salesforce. Deletions are typically one-way or require manual action in the other system. This is a safety measure to prevent accidental data loss. Check your integration settings to confirm the deletion behavior in your setup.

Can I sync HubSpot deals to Salesforce opportunities?

Yes. HubSpot deals map to Salesforce opportunities, including deal value, stage, and close date. However, the mapping may require some configuration if your deal stages or custom fields don’t align with Salesforce’s opportunity structure.

Is there a cost for the integration?

The native integration is included with HubSpot and Salesforce; there’s no additional per-sync fee. However, both platforms charge based on the number of contacts and users, and syncing large volumes of data may increase your API usage. If you use a third-party tool like Zapier, you’ll incur additional costs based on task volume.