How to Connect Hubspot to a Salesforce Sandbox

Connecting your Salesforce sandbox to Hubspot lets you test data sync, workflows, and field mappings in a safe environment before connecting your production account. This step-by-step guide walks you through the full setup process so you can validate your integration with minimal risk.

Before you begin, make sure you have the right permissions in both systems and understand how data will flow between Salesforce and your Hubspot account.

Key prerequisites for Hubspot and Salesforce sandbox setup

To successfully connect a Salesforce sandbox to Hubspot, confirm the following requirements are met.

Required permissions in Salesforce

Your Salesforce user must have:

API access enabled for the user profile.
Permission to install and manage connected apps.
Access to the sandbox where Hubspot will connect.

Required permissions in Hubspot

In Hubspot, your user needs:

Super admin permissions, or
Specific integration and app marketplace access.

If you are unsure about your access level, ask an admin to confirm you can install and configure integrations in your Hubspot portal.

Step 1: Prepare your Salesforce sandbox for Hubspot

Start on the Salesforce side so the sandbox is ready when you create the connection from Hubspot.

Log in to your Salesforce sandbox environment instead of production.
Verify that API access is enabled for your user profile and that your sandbox is active.
Review any sandbox-specific security settings that might affect third-party integrations.

It is a best practice to mirror key configuration elements (objects, fields, and validation rules) from production to your sandbox before you connect Hubspot. This allows your tests to reflect real-world conditions.

Step 2: Open the Salesforce integration in Hubspot

Once the sandbox is ready, move into Hubspot to configure the connection.

Sign in to your Hubspot account with an admin or integration-enabled user.
Navigate to your account settings.
Go to the integrations or connected apps section and locate the Salesforce integration option.
If the integration is not yet installed, follow the prompts to begin the installation process from the Hubspot app marketplace.

You will be redirected through a series of prompts that guide you to log in with your Salesforce sandbox credentials and confirm authorization.

Step 3: Choose the Salesforce sandbox environment in Hubspot

When you start the connection, Hubspot needs to know that you are linking a sandbox rather than a production org.

In the Salesforce connection wizard within Hubspot, select the option to connect to Salesforce.
When prompted to choose an environment, select Sandbox instead of Production.
Confirm that the URL and environment details match your Salesforce sandbox.

Selecting a sandbox ensures data is safely exchanged only with your test environment and not with live customer records.

Step 4: Authorize the connection between Hubspot and Salesforce sandbox

After choosing the sandbox environment, you must authorize the integration so Hubspot can communicate with Salesforce.

You will be redirected to a Salesforce login page for the sandbox.
Enter your sandbox username and password.
Review the list of permissions that the Hubspot integration is requesting, such as the ability to read and write contacts, companies, and opportunities.
Click to approve and authorize the connected app so the systems can sync data.

Once authorization is complete, you should be redirected back to Hubspot where the connection status will indicate that the sandbox is now linked.

Step 5: Configure sync settings in Hubspot for the sandbox

With the connection established, you can fine-tune how data moves between the systems within Hubspot.

Set object and record sync behavior

In the Hubspot Salesforce integration settings, configure:

Which objects will sync (e.g., contacts, companies, deals).
Sync direction for each object (Hubspot to Salesforce, Salesforce to Hubspot, or bidirectional).
Rules for creating new records versus updating existing ones.

Choose sandbox settings that closely match how you plan to run the integration in production. This ensures your testing accurately reflects your live Hubspot and Salesforce data strategy.

Map fields between Salesforce and Hubspot

Next, align fields so data is consistent across both platforms.

Open the field mappings area in the Salesforce integration settings in Hubspot.
Review the default mappings for standard fields such as name, email, and lifecycle stage.
Add or adjust custom field mappings to match your Salesforce schema.
Confirm that important required fields in Salesforce have appropriate Hubspot counterparts.

Well-planned field mappings help prevent sync errors and keep your CRM data clean while you test in the sandbox.

Step 6: Test the Hubspot and Salesforce sandbox connection

Before you move to production, run structured tests in the sandbox integration.

Basic sync tests

Perform simple checks first:

Create a new contact in Hubspot and confirm it appears in your Salesforce sandbox.
Create a lead or contact in Salesforce and verify that it syncs back to Hubspot.
Update a few fields on both sides and confirm changes are reflected correctly.

Workflow and automation tests

If you use workflows or automation in Hubspot that depend on Salesforce data:

Trigger workflows from contact or company updates and track the resulting actions.
Confirm that deals, tasks, or activities created by automation appear correctly in the Salesforce sandbox.
Check that any lifecycle or status updates propagate between the systems as planned.

Document your test scenarios and outcomes so you can compare them once you connect Hubspot to your Salesforce production environment.

Step 7: Review security and disconnect options in Hubspot

Managing access and understanding how to disconnect the sandbox keeps your environment secure.

Review which Hubspot users can view and manage the Salesforce integration.
Confirm that sensitive sandbox data is handled in line with your internal policies.
In the integration settings, note the option to disconnect the Salesforce sandbox from Hubspot when testing is complete.

When you disconnect, you prevent further data sync while still preserving test records already created in each system.

Moving from Salesforce sandbox to production with Hubspot

Once you are satisfied with your testing, you can plan a transition from sandbox to production.

Document your final object sync rules and field mappings in Hubspot.
Replicate the same configuration for your production Salesforce connection.
Schedule the go-live at a time with lower activity to minimize impact on users.

Run a limited pilot with a subset of records before fully opening the sync between Hubspot and your live Salesforce org.

Helpful resources for Hubspot and Salesforce users

For the original step-by-step product documentation from the platform provider, see the official guide on how to connect a Salesforce sandbox to Hubspot.

If you need expert help designing or optimizing your Salesforce and Hubspot integration strategy, you can also consult a specialist partner such as Consultevo.

By carefully configuring your Salesforce sandbox connection in Hubspot and validating every step, you reduce risk and ensure a smooth rollout when you are ready to integrate with your production CRM.

Need Help With Hubspot?

If you want expert help building, automating, or scaling your Hubspot , work with ConsultEvo, a team who has a decade of Hubspot experience.

Scale Hubspot

“`

Connect Hupspot to Salesforce Sandbox