Back to Top

User Guide for ERPNext Hubspot CRM Connector

Updated 12 June 2026

Introduction

The ERPNext HubSpot CRM Connector helps businesses synchronize Contacts, Leads, Opportunities (Deals), and Products between ERPNext and HubSpot CRM.

You can purchase the ERPNext HubSpot CRM Connector directly from the Webkul Store. The connector eliminates manual data entry and keeps customer and sales data synchronized across both platforms.

With this ERPNext HubSpot CRM Integration, businesses can manage CRM operations from ERPNext while maintaining accurate records in HubSpot CRM.

The connector supports bidirectional synchronization, duplicate prevention, record mapping, and multiple HubSpot CRM account management.

Prerequisites for using ERPNext HubSpot CRM Connector

ERPNext HubSpot CRM Connector works in conjunction with the following module:

ERPNext Multi CRM Base

You must install the above-mentioned module to use ERPNext HubSpot CRM Connector.

Features

  1. Synchronize Contacts between ERPNext and HubSpot CRM.
  2. Synchronize Leads between ERPNext and HubSpot CRM.
  3. Synchronize Opportunities (Deals) between ERPNext and HubSpot CRM.
  4. Synchronize Products and Items between ERPNext and HubSpot CRM.
  5. Prevent duplicate Contacts using email matching.
  6. Prevent duplicate Products using SKU matching.
  7. Manage multiple HubSpot CRM accounts from ERPNext.
  8. Maintain CRM entity mapping for synchronized records.
  9. Automatically update synchronized records.
  10. Secure OAuth2 authentication with HubSpot CRM.

Installation

  1. After purchasing the app from the Webkul store, you will receive a link to download the module ZIP file.
  2. Extract the downloaded ZIP file, and you will see a folder named ‘erpnext_hubspot_crm_connector’.
  3. Set up the module in your Git repository.
  4. If the app is hosted on GitHub, fetch it using the command:
bench get-app --branch main
https://github.com/your-account/erpnext_hubspot_crm_connector.git

● (Replace “main” with your branch name and replace the “HTTPs URL” with your HTTPS clone
URL.)

5. Install the app on your site using the command:

bench --site <your-site_name> install-app erpnext_hubspot_crm_connector

6. Finally, run the “bench migrate” command to complete the installation.

Workflow

Configure Connector Type

Navigate to Multi CRM → Connector Types.

Create a new Connector Type for HubSpot CRM and enter the required API details.

configure connector type

Create Connector Account

Navigate to Connector Accounts.

Create a new HubSpot CRM account by entering the details.

create account

Connect HubSpot CRM

Click Save and Connect.

Authenticate your HubSpot CRM account and validate the connection.

save

Import Records from HubSpot CRM

Import Contacts, Leads, Opportunities, and Products from HubSpot CRM into ERPNext.

import

Export Records to HubSpot CRM

Export Contacts, Leads, Opportunities, and Products from ERPNext to HubSpot CRM.

export

View Authentication Logs

Navigate to Authentication Logs.

Review authentication events and connection status.

auth

View Synchronization Logs

Navigate to Sync Logs.

Review synchronized records between ERPNext and HubSpot CRM.

syync log

Manage Entity Mapping

Navigate to Entity Types.

View CRM entity mappings created between ERPNext and HubSpot CRM.

entity mapping

Generate HubSpot Client ID and Client Secret

Step 1

Log in to your HubSpot Developer Account.

Click Create legacy App.

legacy app

Step 2

Enter app details like public app name, app logo, and description.

app info

Step 3

Copy the generated Client ID and Client Secret.

Use these credentials while creating the Connector Account.

client id

Step 4

Configure application details and OAuth settings. Add the Redirect URL required for ERPNext authentication.

Oauth details and redirect url

Step 5

Configure the required scopes

enter required scopes

Need Help?

Hope you find the guide helpful! Please feel free to share your feedback in the comments below.

If you still have any issues or queries, please create a ticket at the UV Desk.

I hope this helps. In case of any further queries, contact us through our support email: [email protected]

Thanks for paying attention!!

Current Product Version - 1.5.0

Supported Framework Version - ERPNext V15

. . .

Leave a Comment

Your email address will not be published. Required fields are marked*


Be the first to comment.

Back to Top

Message Sent!

If you have more details or questions, you can reply to the received confirmation email.

Back to Home

User Guide for ERPNext Hubspot CRM Connector