How to Change Your Salesforce Integration User in Hubspot

Managing the Salesforce integration user in Hubspot is critical for keeping your CRM data synced, secure, and under the right owner account. This guide walks you step by step through changing the integration user or connecting a different Salesforce account so that syncs continue smoothly.

The process involves moving sync ownership, updating sync settings, and reconnecting the integration with the correct Salesforce user, while minimizing risk to your existing data.

Before You Change the Salesforce User in Hubspot

Before you update the Salesforce integration user in Hubspot, you need to understand how the connector currently works and what may be affected.

How the current Hubspot–Salesforce integration works

When you first connect Salesforce, a single integration user is authorized. This user:

Owns the authentication token used for API calls.
Controls which objects and fields are available to sync.
Determines the visible records in Salesforce that Hubspot can access.
May own records created by the integration in Salesforce.

Any change to this integration user can affect sync permissions and visibility, so planning is important.

Why you might change the integration user in Hubspot

Common reasons teams switch the Salesforce integration user include:

The existing user is leaving the company.
You want a dedicated system account for Hubspot syncs.
Security or permission changes require a new owner.
You need broader or more limited access to records in Salesforce.

Regardless of the reason, you should always coordinate with your Salesforce admin before proceeding.

Key Requirements for the New Salesforce User in Hubspot

The new Salesforce user that will connect to Hubspot must meet specific requirements. Without them, the integration may fail or only partially sync data.

Salesforce access and profile requirements

Confirm that the new Salesforce user has:

API access enabled in their profile or permission set.
Read and edit permissions for the objects you sync (e.g., Leads, Contacts, Accounts, Opportunities).
Access to all essential fields mapped between Salesforce and Hubspot.
Visibility into the records that should sync, based on your sharing rules and role hierarchy.

If the new Salesforce user has more restrictive access, Hubspot may no longer see or update certain records.

Hubspot integration settings to review

In your Hubspot account, review the integration settings before making changes:

Objects currently set to sync between Hubspot and Salesforce.
Field mappings and which side (Hubspot or Salesforce) wins on conflicts.
Sync filters or inclusion lists that limit which records are sent.
Any workflows or automation that depend on Salesforce sync data.

Document these settings so you can quickly verify that everything works as expected after switching the integration user.

How to Change the Salesforce Integration User in Hubspot

Follow these structured steps to safely switch the Salesforce integration user in Hubspot. You will temporarily disconnect and reconnect the integration using the new Salesforce user credentials.

Step 1: Prepare Salesforce and Hubspot admins

Identify both the current integration user and the new Salesforce user.
Ensure the new user is fully configured in Salesforce with the required permissions.
Confirm you have Super Admin or equivalent access in Hubspot to edit connected apps.
Notify stakeholders that a short sync interruption will occur during the change.

Coordinating between your Salesforce and Hubspot admins reduces the risk of unexpected sync issues.

Step 2: Review current sync behavior in Hubspot

In Hubspot, go to your Salesforce integration settings.
Review each syncing object (Contacts, Companies, Deals, etc.).
Export or record important field mappings so you can validate them later.
Note any custom objects or special mappings that the integration relies on.

This step creates a baseline. After reconnecting, you will compare and confirm that nothing has changed unintentionally.

Step 3: Disconnect the current Salesforce integration user

When ready to switch, you must disconnect the existing integration user from Hubspot.

Navigate to your Hubspot account settings.
Open the list of connected apps or integrations.
Select the Salesforce integration.
Locate the option to disconnect or log out the current Salesforce user.
Confirm the disconnection when prompted.

Once disconnected, syncs between Hubspot and Salesforce will pause until you reconnect with the new user.

Step 4: Connect the new Salesforce user to Hubspot

Immediately reconnect with the new user to limit downtime.

In the same Salesforce integration area of Hubspot, choose the option to connect Salesforce.
When redirected, log in using the new Salesforce user’s credentials.
Authorize Hubspot to access Salesforce on behalf of this new integration user.
Return to Hubspot and wait for confirmation that the connection is successful.

If you see authentication or permission errors, verify the Salesforce profile, permission sets, and API access for the new user.

Verifying and Testing Your New Salesforce User in Hubspot

After reconnecting, you must verify that the Salesforce integration behaves correctly with the new user in Hubspot.

Check object sync status in Hubspot

Open the Salesforce integration dashboard in Hubspot.
Check the status of each syncing object for errors.
Confirm that new sync cycles are running with a recent last-sync time.
Review any error logs or warning messages related to access or field visibility.

If specific objects fail to sync, adjust Salesforce permissions for the new user and re-run the sync.

Validate record-level access and changes

To ensure data remains accurate between Salesforce and Hubspot, spot-check records:

Create or update a test contact in Hubspot and confirm it appears in Salesforce.
Create or update a test lead in Salesforce and verify it syncs to Hubspot.
Check ownership, lifecycle stage, and critical custom fields for correctness.
Verify that workflows or automation dependent on Salesforce fields still run as expected.

Perform these tests for each major object you sync, such as Contacts, Companies, and Deals.

Troubleshooting Common Issues After a Hubspot Salesforce User Change

If problems appear after changing the integration user in Hubspot, work through the most common causes.

Permission and visibility issues for the new user

Typical symptoms include missing records, partial syncs, or errors in Hubspot logs. To resolve:

Confirm the new Salesforce user can see all required records via sharing rules.
Grant read and edit access to any newly restricted objects or fields.
Update role hierarchy or permission sets as needed.

Once fixed, re-run or re-enqueue affected syncs from the integration panel in Hubspot.

Field mapping or conflict behavior changes

Although changing the integration user does not automatically change mappings, issues may surface if the new user lacks access to certain fields. Review:

All field mappings between Salesforce and Hubspot in the integration settings.
Conflict resolution rules to ensure the correct system is authoritative.
Any new or removed fields since the original integration setup.

After adjusting mappings, run another test sync to verify accuracy.

Best Practices for Managing the Salesforce Integration User in Hubspot

To maintain a healthy integration long term, implement these practices around Salesforce and Hubspot administration.

Use a dedicated integration user

Where possible, configure a dedicated Salesforce user for Hubspot with:

A stable profile that rarely changes.
Consistent API access and broad, appropriate permissions.
Clearly documented purpose as the integration owner.

This reduces disruptions caused by employee turnover or role changes.

Document your Hubspot–Salesforce configuration

Maintain written documentation that includes:

Which Salesforce user is currently connected to Hubspot.
Objects and fields configured to sync.
Conflict resolution rules and sync filters.
Key automations that rely on Salesforce data in Hubspot.

Good documentation simplifies future integration changes and audits.

Additional Resources for Hubspot Salesforce Integration

For more detailed and official instructions on changing the integration user or connecting a different Salesforce account, refer to the original Hubspot knowledge base article: Change your Salesforce integration user or connect a different Salesforce account.

If you need expert implementation or consulting help to design a scalable Hubspot and Salesforce architecture, you can also visit Consultevo for professional CRM and marketing operations support.

By following the steps outlined above and validating permissions, field mappings, and object syncs, you can safely change your Salesforce integration user in Hubspot without losing control of your customer data.

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

“`

Hupspot Salesforce user change guide