Connect HubSpot with Microsoft Dynamics 365

Connecting Hubspot with Microsoft Dynamics 365 lets your sales and marketing teams work from unified, accurate data. This guide explains the requirements, setup steps, and key options you need to know before you turn on the integration.

Before you connect HubSpot and Dynamics 365

Before you start the connection process, review the prerequisites for both systems. Confirm that you can meet the technical and permission requirements so the integration works smoothly from day one.

HubSpot account requirements

To connect to Microsoft Dynamics 365, your HubSpot account must meet specific criteria. These requirements protect your CRM data and ensure that records sync correctly between platforms.

• You must have super admin permissions in your HubSpot account.
• Your subscription must include integration access compatible with Dynamics 365.
• Your user must have permission to install apps and manage connected apps.
• The account should be in good standing, without any integration restrictions.

If you manage multiple accounts, confirm you are in the correct HubSpot portal before you proceed with the integration steps.

Microsoft Dynamics 365 requirements

You also need the right permissions and environment in Microsoft Dynamics 365. Make sure you have access to the environment where you intend to sync records from HubSpot.

• A valid Microsoft Dynamics 365 subscription.
• Administrator or equivalent permissions to approve third-party apps.
• Access to the correct environment (production or sandbox) for your integration.
• Any required security roles configured for API and integration access.

Coordinate with your Dynamics administrator to confirm which environment you will connect and which records should be available to sync with HubSpot.

How to install the HubSpot and Dynamics 365 integration

Once you confirm that both systems are ready, you can install the integration app. The process starts from the HubSpot marketplace and finishes with authorization in Microsoft Dynamics 365.

Step 1: Open the HubSpot app marketplace

Start the process inside your CRM so you can authorize the right account.

1. Log in to your HubSpot account as a super admin user.
2. Navigate to the App Marketplace from the main navigation.
3. Use the search bar to look for the Microsoft Dynamics 365 integration listing.

Review the description, requirements, and permissions listed in the marketplace card before you install the app.

Step 2: Connect your Microsoft Dynamics 365 account

When you are ready to connect, follow the prompts shown in the marketplace listing.

1. Click Install app on the Microsoft Dynamics 365 integration card in HubSpot.
2. You will be redirected to sign in with your Microsoft credentials, if you are not already logged in.
3. Select the correct Microsoft Dynamics 365 environment that you want to sync with HubSpot.
4. Review the requested permissions, then click to accept and authorize the connection.

After authorization, you will be redirected back to your HubSpot account, where you can access the integration settings and sync options.

Configure sync between HubSpot and Dynamics 365

After the installation is complete, configure how data should move between the two CRMs. Planning these settings upfront helps you avoid duplicates and conflicting records.

Select objects to sync with HubSpot

Choose which records you want to keep aligned between your systems. The integration supports syncing common CRM objects between HubSpot and Microsoft Dynamics 365.

• Contacts and leads
• Companies or accounts
• Deals or opportunities
• Custom fields mapped between the two platforms (where supported)

Decide which objects are needed for your sales and marketing processes and enable only those that should sync to or from HubSpot.

Set sync direction and rules

Next, define how updates should flow between your databases. Consistent rules are essential so that new and edited records behave as expected across both platforms.

• Choose one-way sync from Dynamics 365 to HubSpot if you only want to surface data in your marketing system.
• Choose one-way sync from HubSpot to Dynamics 365 if your CRM of record is HubSpot.
• Choose two-way sync if you want both platforms to update each other when records change.
• Set conflict rules so that the most recent or the source-of-truth system wins when there are data differences.

Document your sync rules and make sure your team understands which platform should be treated as the primary source for each type of data.

Manage field mappings in HubSpot

Field mappings control which properties are synchronized between the systems and how the values are translated. Review the default mappings that are automatically created, then update them as needed.

Review default property mappings

When the integration is first connected, standard CRM properties are usually mapped between HubSpot and Microsoft Dynamics 365 automatically. These default mappings might include:

• Contact name, email, and phone fields
• Company name and domain
• Deal name, amount, and stage
• Lifecycle stage or lead status where available

Confirm that these mappings align with how your organization uses both systems. Adjust any mapping that could cause confusion or incorrect segmentation in HubSpot.

Create custom mappings between HubSpot and Dynamics 365

If you rely on custom data points, create new mappings so those fields are available in both tools.

1. Go to your integration settings in HubSpot.
2. Select the object you want to update, such as contacts or companies.
3. Add a new mapping and choose the HubSpot property to sync.
4. Select the corresponding field in Microsoft Dynamics 365.
5. Save the new mapping and confirm the sync direction.

Test your new mappings with a small group of records to verify that the data appears correctly on both sides of the integration.

Control user access for the HubSpot integration

Because this connection can change large volumes of CRM data, limit who can configure or disconnect the integration. Use role-based permissions to keep your systems secure.

Assign permissions in HubSpot

Inside your account, only specific users should be allowed to manage the Dynamics 365 integration.

• Grant super admin or integration admin permissions only to trusted users.
• Restrict access to integration settings for general sales and marketing users.
• Review permissions regularly to remove access for inactive or changed roles.

Clear governance in HubSpot prevents accidental changes to your sync configuration and protects your source-of-truth data.

Manage access in Microsoft Dynamics 365

In addition to controls in your marketing CRM, enforce permissions inside Microsoft Dynamics 365 so only the right administrators can approve application access.

• Limit which users can approve third-party apps connected to your instance.
• Use security roles that define which data the integration can read or write.
• Review sign-in and audit logs to monitor how the HubSpot integration is used.

Tightening access on both sides of the connection helps maintain data integrity and compliance standards.

Monitor and troubleshoot the HubSpot integration

After going live, you should regularly monitor sync activity so you can spot and resolve any issues early. Both systems provide tools to help you understand what is happening with the integration.

Check sync status and logs in HubSpot

The integration dashboard displays recent sync activity and any records that failed to sync.

• Review sync logs for error messages and details about failed records.
• Filter by object type, such as contacts or companies, to narrow your review.
• Use the logs to identify missing permissions, mismatched fields, or invalid data formats.

Correct issues in either system, then allow time for the integration to retry syncing those records between HubSpot and Microsoft Dynamics 365.

When to pause or disconnect the integration

In some situations you may need to temporarily pause or fully disconnect your integration.

• Pause the sync before large data migrations or structure changes.
• Disconnect if you are deprecating a Dynamics 365 environment or changing CRMs.
• Always export critical records before making permanent changes.

Plan any major changes in advance so that you do not lose valuable data that has been synced between the two platforms.

Learn more about connecting HubSpot and Dynamics 365

For detailed, field-by-field behavior and the most current limitations of the integration, always refer to the official documentation from the platform provider. You can review the latest instructions and supported features in the original help article on connecting HubSpot and Microsoft Dynamics 365.

If you need strategic help planning your CRM architecture, mapping fields, or designing cross-platform workflows, you can also work with a consulting partner. Visit Consultevo to explore expert services for implementing and optimizing your CRM integrations.

By following these steps, you can connect HubSpot with Microsoft Dynamics 365 in a structured, secure way that keeps your customer data aligned and ready for sales and marketing teams to use.

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

“`