HubSpot-Salesforce Integration: 2026 Workflow Guide

If your marketing ops tools don’t talk to each other, you’re just making work for yourself. Getting your platforms connected, especially your CRM and analytics, is what separates teams that run efficient campaigns from those that just spin their wheels. This guide walks through setting up smooth workflows in a marketing automation platform so you can actually show the impact you’re having.

Step 1: Initial Connector Setup and Authentication

A good integration starts with linking your core platforms correctly. Let’s get this done. For this guide, I’m using HubSpot for marketing automation and Salesforce Sales Cloud as the CRM, which is a really common setup you’ll see in 2026. This first step just creates the secure link between the two systems so they can pass data back and forth.

1.1 Accessing the Integration Marketplace

Get logged into your HubSpot portal. Find the ‘gear’ icon for Settings in the main nav bar and click it. On the left menu, find ‘Integrations’ and then pick Connected Apps. You’ll see a list of everything you’ve already connected and a button to get to the ‘App Marketplace’.

1.2 Locating the Salesforce Connector

Once you’re on the ‘Connected Apps’ page, hit the ‘Visit App Marketplace’ button which is usually in the top right. Just type “Salesforce” into the search bar. The official Salesforce integration built by HubSpot will be the first thing you see. Click it.

1.3 Initiating the Connection

On the integration’s detail page, click ‘Connect app’. HubSpot will pop up a login window for your Salesforce account. It’s critical that you use a Salesforce account with administrator privileges, otherwise it won’t be able to grant all the permissions needed for data access. You’ll review the requested permissions like ‘Access and manage your data’ and ‘Perform requests on your behalf’, which are standard for this kind of sync. Click Allow and you’re on your way.

Pro Tip: Before you even start, double-check that the Salesforce user profile you’re using for the integration has the right object and field-level security permissions. A very common mistake is using a profile that can’t see or edit certain fields, which causes sync errors down the line. I’ve personally seen teams waste days troubleshooting what ended up being a simple permission setting.

Step 2: Configuring Data Synchronization Rules

Now that they’re connected, you have to tell the systems how to share data. This is about setting up the rules for how contacts, companies, and deals flow between HubSpot and Salesforce.

2.1 Setting Up Contact Synchronization

You should be in the HubSpot-Salesforce integration settings now. Under the ‘Sync Contacts’ tab, you need to choose the data flow. Select “All contacts from HubSpot sync to Salesforce” and also “All leads and contacts from Salesforce sync to HubSpot.” You want a two-way street here. A bi-directional sync is the only way to get a single, unified view of your customer data.

Then look for the ‘When a record is updated’ setting. For both systems, you should choose “Always create/update record in [other system]” so the newest information always wins, no matter where the change was made. Go ahead and set the ‘Sync frequency’ to Every 15 minutes for pretty close to real-time updates. There’s a HubSpot report out there that found companies with tight CRM and marketing platform integration see sales productivity jump by 15%.

2.2 Mapping Custom Fields

This is where you get your money’s worth from the integration. Go to the ‘Field Mappings’ tab. HubSpot maps some standard fields for you, but the real value is in your custom fields. Click Add new field mapping. You need to go through each important custom field you have (like ‘Product Interest’, ‘Lead Source Detail’, etc.) and match the HubSpot property to the right Salesforce field on the Lead or Contact object. Make sure the field types match up, like text-to-text. For example, you might have a ‘Last Marketing Interaction’ date field in Salesforce that you need to map to your ‘Last Engagement Date’ property in HubSpot.

Common Mistake: People often forget to map their most important custom fields. This creates huge data gaps and means your sales reps are either flying blind or constantly switching between systems to find information. My rule is to map at least 10 key custom fields that actually affect how a lead is qualified or sold to. Without that context from marketing, your sales team is working at a disadvantage.

2.3 Configuring Company and Deal Sync

Do the same thing for ‘Companies’ and ‘Deals’ if they’re part of your process. Under the ‘Sync Companies’ tab, I usually tell people to select “All companies from HubSpot sync to Salesforce accounts” and “All accounts from Salesforce sync to HubSpot.” For deals, pay special attention to mapping deal stages, amounts, and close dates correctly. This setup gives sales the marketing context they need and gives marketing visibility into actual sales outcomes.

Step 3: Automating Lead Scoring and Handoff

A huge reason to connect these systems is to automate how you qualify leads and hand them over to sales. This means pushing lead scores and lifecycle stage updates from one system to the other without anyone having to lift a finger.

3.1 Setting Up Lead Score Synchronization

Back in the HubSpot-Salesforce integration settings, find the ‘Field Mappings’ tab again. Find your ‘Lead Score’ property in HubSpot. You’ll want to map this to a custom field you’ve created in Salesforce (I usually name it ‘HubSpot Score’) on both the Lead and Contact objects. For this mapping, set the sync direction to “HubSpot to Salesforce” only. This pushes the lead score that HubSpot calculates right into Salesforce where your sales reps can see it.

3.2 Automating Lifecycle Stage Updates

Now, in HubSpot, go to Automation > Workflows and create a new one. The enrollment trigger should be when the ‘Contact Property is known’ for your ‘HubSpot Score’. Then add an ‘If/then branch’. For example, you could say if the ‘HubSpot Score’ is 75 or higher, then change the contact’s ‘Lifecycle Stage’ to ‘Marketing Qualified Lead’ (MQL). Because the lifecycle stage property should be mapped bi-directionally, this change in HubSpot automatically shows up in Salesforce.

You also need to close the loop. Create a workflow rule in Salesforce that updates a custom field (maybe called ‘Sales Accepted Date’) when a sales rep changes a lead’s status to ‘Accepted’. That custom field in Salesforce should then be mapped back to a HubSpot property. This allows your HubSpot workflows to react to what sales is doing, like pulling a new MQL out of a nurture sequence once sales has accepted it.

Expected Outcome: When this is set up right, your sales team sees lead scores and lifecycle stages in Salesforce in real time, letting them focus on the hottest leads first. And for marketing? You get to see how sales is actually working the leads you send them, which helps you tweak your campaigns for better results. This closed-loop feedback is incredibly valuable, but a lot of companies never get around to setting it up properly.

Step 4: Integrating Campaign Performance Data

To know if your marketing campaigns are working, you have to pull engagement data into your CRM and then get the sales results back into your marketing platform.

4.1 Syncing Campaign Membership and Engagement

In your HubSpot-Salesforce integration settings, look under ‘Sync Activities’. Make sure you’ve checked the boxes for ‘Marketing email opens’, ‘Clicks’, ‘Form submissions’, and ‘Website visits’ to sync as tasks or events in Salesforce. This gives your sales reps a full activity timeline for every lead and contact right inside the Salesforce record they live in all day.

While you’re there, go to ‘Field Mappings’ and map HubSpot’s ‘Original Source Drill-down 1’ and ‘Original Source Drill-down 2’ properties. Map them to some custom fields in Salesforce (call them ‘HubSpot Original Source’ and ‘HubSpot Original Source Detail’ or something similar). This puts the lead’s origin story right into Salesforce, which helps sales reps understand where they came from and gives you much better reporting on marketing’s pipeline influence.

4.2 Reporting on Revenue Attribution

To actually measure ROI, you need the sales outcome data from Salesforce to come back into HubSpot. Make sure the ‘Deal Stage’ and ‘Amount’ from Salesforce Deals are mapped to the right properties in HubSpot. This is what lets HubSpot’s attribution reporting connect a specific marketing email or whitepaper download to a closed-won deal. For example, if a $10,000 deal closes, and HubSpot can see that the contact on that deal opened a certain email campaign, those marketing activities get credit for a piece of that revenue.

Pro Tip: Don’t just sync the data, use it. You have to get in the habit of regularly checking your HubSpot attribution reports (they’re under Reports > Analytics Tools > Attribution Reports). Powered by your Salesforce data, these reports will finally show you which channels and campaigns are driving real money. In 2026, for example, I’ve seen a lot of companies finally prove that their top-of-funnel blog posts were directly contributing to new deals, a finding that’s only possible when this integration is solid.

Step 5: Maintaining and Troubleshooting Your Integration

An integration isn’t something you can just set up and walk away from. You’ve got to monitor it to make sure the data stays clean and both systems are performing well.

5.1 Monitoring Sync Health

In HubSpot, go back to Settings > Integrations > Connected Apps and click your Salesforce integration. There’s a ‘Sync Health’ tab that shows you a dashboard of what’s been syncing and, more importantly, what hasn’t. Keep a close eye on ‘Sync Errors’ and ‘Records in Queue’. A big number of errors usually points to a problem like a field mapping mismatch, a permissions issue in Salesforce, or a validation rule that’s blocking records.

You can click on any error to get the details. It will usually tell you which record failed and why. A classic one is “REQUIRED_FIELD_MISSING: [Field Name]: Required.” This just means a field that’s required in Salesforce didn’t get any data from HubSpot. You need to jump on these errors quickly to stop data from getting out of sync.

5.2 Regular Field Mapping Reviews

I tell my clients to do a quarterly review of their field mappings. Your business changes, right? People add new custom fields in HubSpot or Salesforce all the time. If those new fields are important for your segmentation or reporting, they have to be mapped in the integration settings. Just go to Settings > Integrations > Connected Apps > Salesforce > Field Mappings and look through what you have, adding new mappings where they’re needed.

Editorial Aside: So many teams get excited about the initial setup and then completely forget about maintenance. This is a huge mistake. An integration that isn’t being watched will slowly break down, filling your systems with bad data and destroying any trust between marketing and sales. It’s like buying a race car and never changing the oil. Eventually, the engine is going to seize.

5.3 Testing Changes in a Sandbox Environment

If you’re going to make a big change to your field mappings or workflows that affect the sync, you should test it in a Salesforce Sandbox first. You can often connect your HubSpot developer account to a Sandbox. This lets you see exactly how the data will flow and catch any problems before you mess up your live production environment. This one step can save you so many hours of cleanup and painful troubleshooting later.

Paying attention to your martech integration makes sure your efficiency tools actually do what they’re supposed to: give you good data for making decisions and help marketing and sales finally get on the same page.

Solid martech integration is what holds modern marketing together, turning a bunch of separate tools into a single machine. If you take the time to set up the connectors, define the sync rules, automate your lead flow, and actually maintain the connection, you can build smooth workflows that have a direct line to revenue.