How to Install and Configure the Hubspot Salesforce Integration

The Hubspot Salesforce integration lets your marketing and sales teams share data seamlessly between both platforms. This guide walks through requirements, installation, configuration, and best practices so you can connect Hubspot and Salesforce safely and efficiently.

Before You Connect Hubspot to Salesforce

Before installing the integration, confirm that your systems and users meet the core requirements. Proper preparation prevents sync failures and permissions issues later.

System and Edition Requirements

Review these essentials before connecting Hubspot with Salesforce:

• You must have a Salesforce edition that supports Web Services API access (for example, Enterprise, Unlimited, or others with API enabled).
• You need a Salesforce user dedicated to the integration with a supported license.
• You must have a Hubspot account with access to the Salesforce integration feature.

Check your Salesforce organization limits and any existing integrations that already use API calls, because the Hubspot integration relies on that same daily quota.

Recommended Integration User Setup

It is a best practice to create a specific Salesforce user to manage the Hubspot connection. This improves security and helps with troubleshooting.

Consider these guidelines:

• Create a distinct Salesforce user account only for the integration.
• Assign a profile with appropriate object and field permissions.
• Avoid using personal sales rep accounts for the connection.

Using a dedicated integration user ensures that changes made by the sync can be clearly identified in Salesforce audit trails.

Install the Hubspot Salesforce Integration Package

Once you confirm requirements, you can install the managed package that links Salesforce with Hubspot.

Step 1: Start the Installation from Hubspot

1. Sign in to your Hubspot account with super admin or required permissions.
2. Navigate to your integrations or connected apps settings.
3. Locate the Salesforce integration option and click to begin setup.
4. Choose the environment where you will install Salesforce components (Sandbox or Production).

Hubspot will redirect you to Salesforce to approve and install the package.

Step 2: Approve Package Access in Salesforce

1. Log in to Salesforce as a system administrator or user with installation rights.
2. Review the package components, including fields, layouts, and permissions.
3. Select which users in Salesforce should have access to the installed package.
4. Confirm and complete the package installation process.

After Salesforce confirms installation, you will be sent back to Hubspot to finish configuring the integration.

Authorize Salesforce Access for Hubspot

The integration must be authorized so Hubspot can read and write data to your Salesforce organization.

Connect the Salesforce Integration User

1. In Hubspot, open the Salesforce integration settings.
2. Click the option to connect to Salesforce.
3. Sign in with the dedicated Salesforce integration user credentials.
4. Review and approve the requested OAuth scopes and permissions.

Once authorization is complete, Hubspot can call the Salesforce APIs on behalf of the integration user you selected.

Verify Object and Field Permissions

For a successful sync, confirm the integration user profile has at least read access to required objects and fields, and write access where updates are needed. Common objects include:

• Leads
• Contacts
• Accounts
• Opportunities
• Tasks or Activities

Missing field access is a frequent cause of sync errors when using Hubspot and Salesforce together.

Configure Hubspot Salesforce Sync Settings

After authorization, you can configure how data flows between Hubspot and Salesforce. Careful setup avoids duplicates and unexpected updates.

Choose Objects and Sync Direction

In the Hubspot integration settings, decide which records to sync and in what direction.

• Enable or disable sync for Leads, Contacts, and Accounts based on your process.
• Set sync direction for each mapping (for example, Hubspot to Salesforce, Salesforce to Hubspot, or bidirectional).
• Review how lifecycle stages, lead statuses, and similar fields are mapped between the systems.

Aligning these settings with your existing CRM strategy is crucial for accurate reporting and hand-offs between marketing and sales.

Map Hubspot Properties to Salesforce Fields

Property mapping controls how specific data points move between Hubspot and Salesforce.

1. Open the property or field mapping section in the integration settings.
2. For each Hubspot property, select the corresponding Salesforce field.
3. Confirm field types and formats are compatible (for example, text to text, picklist to picklist).
4. Decide which system is the source of truth when conflicts occur.

Use consistent naming conventions to make future maintenance of your integration easier.

Install the Hubspot Visualforce Components (Optional)

The managed package installs Visualforce pages that show Hubspot insights inside Salesforce. While optional, they help sales teams view marketing engagement directly in the CRM.

Add Hubspot Panels to Salesforce Page Layouts

1. In Salesforce Setup, open the object whose page layout you want to modify, such as Lead or Contact.
2. Edit the page layout and locate the Visualforce pages section.
3. Drag the Hubspot Visualforce panel onto the layout.
4. Adjust the height and placement for optimal visibility.
5. Save your layout changes and test with a sample record.

These panels give reps instant access to recent form submissions, email activity, and website behavior captured by Hubspot.

Test and Troubleshoot Your Hubspot Integration

After configuration, always validate the connection before rolling out to your entire team.

Run Initial Test Syncs

Use a few test records to confirm proper behavior:

• Create a new contact in Hubspot and verify a matching record appears in Salesforce.
• Update values in Salesforce and confirm they sync back to Hubspot where configured.
• Check for duplicate creation when the same person exists in both systems.

Monitor logs and integration health dashboards to identify any sync delays or errors.

Review Common Error Causes

If you encounter issues while connecting Salesforce and Hubspot, investigate:

• Insufficient object or field permissions for the integration user.
• Validation rules in Salesforce blocking updates.
• Picklist mismatches or required fields without default values.
• API limit errors from heavy system usage.

Most sync errors can be resolved by adjusting field mappings, relaxing validation rules for integration updates, or increasing API limits where possible.

Maintain and Optimize Your Hubspot Salesforce Setup

Once the integration is live, periodic reviews keep your Hubspot and Salesforce data aligned and reliable.

Ongoing Administration Tips

Consider these administration practices:

• Regularly audit property and field mappings after new fields are added.
• Review sync rules when your sales process changes.
• Monitor integration logs for recurring errors and address root causes.
• Train new team members on how data flows between Hubspot and Salesforce.

Document your integration decisions so future admins can understand why specific mappings or sync directions were selected.

Additional Resources for Hubspot and Salesforce

For detailed reference on every configuration option, see the official installation guide provided by the platform vendor. You can review the complete instructions for installing the integration package, configuring user permissions, and managing sync behavior at this Salesforce integration article.

If you want strategic help designing a CRM and revenue operations framework around your Hubspot and Salesforce connection, you can also consult specialists at Consultevo for tailored advisory services.

By carefully following these steps, testing your configuration, and maintaining clear ownership, you can run a stable, scalable Hubspot Salesforce integration that keeps sales and marketing aligned on a single, trusted view of every customer.

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

“`