Integrate a new Salesforce production organization with HubSpot

After migrating to a new Salesforce production organization, you can integrate your new production organization with HubSpot.

Before you get started

Before you start migrating, please note the following: 

• This process only applies if you're migrating from a Salesforce production organization where the HubSpot integration package was installed to a new production organization. This process does not apply if you're migrating from a production organization to a sandbox, or vice-versa. Learn how to connect your Salesforce sandbox to HubSpot.
• Integrating a new Salesforce production organization with HubSpot will require turning off the HubSpot-Salesforce integration for approximately one hour.
• At this time, only the sync and relationship between existing HubSpot contacts and Salesforce leads or contacts can be maintained when integrating a new Salesforce production organization to HubSpot. The sync and relationship between existing HubSpot companies and Salesforce accounts, as well as between HubSpot deals and Salesforce opportunities, will be lost.

Connect the new Salesforce production organization to HubSpot

1. In your HubSpot account, click the settings settings icon in the top navigation bar. In the left sidebar menu, navigate to Integrations > Connected Apps.
2. Click Salesforce. 
3. In the upper right, click to toggle the switch off to turn off the integration.
4. Install the integration package in your new Salesforce production organization.
5. Export the HubSpot contacts you want to continue syncing with your new Salesforce production organization.
6. Import the exported HubSpot contacts into your new Salesforce production organization.
7. Create or edit any custom field mappings that were previously mapped between your old Salesforce production organization and HubSpot.

Please note: existing custom field mappings can be kept if the HubSpot property is mapped to a Salesforce field that also exists in the new production organization. The internal name of the Salesforce field in the new production organization must also match the internal name of the Salesforce field in the old production organization. If not, create new field mappings and delete old field mappings to avoid sync errors.

8. After one hour has passed, connect your new Salesforce production organization to HubSpot.
9. In the upper right, click to toggle the switch on to turn the integration on.
10. Import the Salesforce leads/contacts back into HubSpot. The import will deduplicate the Salesforce leads and contacts against the existing HubSpot contacts. It'll also refresh the Salesforce record IDs of the existing HubSpot contacts to associate them with the Salesforce leads and contacts in the new production organization.