PHPackages                             batchnz/hub-spot-ecommerce-bridge - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. batchnz/hub-spot-ecommerce-bridge

ActiveCraft-plugin[API Development](/categories/api)

batchnz/hub-spot-ecommerce-bridge
=================================

Uses the HubSpot Ecommerce Bridge to sync data from Craft Commerce

2.2.3(2y ago)1109MITPHP

Since Oct 28Pushed 2y agoCompare

[ Source](https://github.com/batchnz/hub-spot-ecommerce-bridge)[ Packagist](https://packagist.org/packages/batchnz/hub-spot-ecommerce-bridge)[ RSS](/packages/batchnz-hub-spot-ecommerce-bridge/feed)WikiDiscussions master Synced yesterday

READMEChangelog (10)Dependencies (4)Versions (25)Used By (0)

HubSpot Commerce plugin for Craft CMS 4.x
=========================================

[](#hubspot-commerce-plugin-for-craft-cms-4x)

Sync data between Craft Commerce and HubSpot using the HubSpot Ecommerce Bridge

Requirements
------------

[](#requirements)

This plugin requires Craft CMS 4.0.0 or later as well as Craft Commerce 4.0.0 or later.

It is also required to have a Hubspot account and the ability to create private apps for it.

Installation
------------

[](#installation)

To install the plugin, follow these instructions.

1. Open your terminal and go to your Craft project:

    ```
     cd /path/to/project

    ```
2. Then tell Composer to load the plugin:

    ```
     composer require batchnz/hub-spot-ecommerce-bridge

    ```
3. In the Control Panel, go to Settings → Plugins and click the “Install” button for HubSpot Commerce.

HubSpot Commerce Overview
-------------------------

[](#hubspot-commerce-overview)

Hubspot Commerce automatically syncs all commerce related data from Craft to Hubspot. The models that are synced are:

Craft ModelHubspot ModelOrderDealUserContactProductProductConfiguring HubSpot Commerce
----------------------------

[](#configuring-hubspot-commerce)

### Private App

[](#private-app)

1. Create a private app within Hubspot and make sure to give it the following Scopes:
    1. e-commerce
    2. crm.objects.contacts.read
    3. crm.objects.contacts.write
    4. crm.schemas.custom.read
    5. crm.schemas.contacts.read
    6. crm.objects.deals.read
    7. crm.objects.deals.write
    8. crm.schemas.contacts.write
    9. crm.schemas.deals.read
    10. crm.schemas.deals.write
    11. crm.objects.line\_items.read
    12. crm.objects.line\_items.write
    13. crm.schemas.line\_items.read
2. Navigate to `Hubspot Commerce -> Settings` within the cp and enter the Access token for the private app you created and click Save. **Note:**You need to have admin permission to access this setting section. It is also recommended to store this as an ENV variable.

### Mappings

[](#mappings)

You can configure which Hubspot properties the Craft Commerce fields will map to. Head to `Hubspot Commerce -> Mappings`within the cp and configure which Hubspot properties each of the Craft Commerce fields will map to.

**IMPORTANT:** The properties you configure for mappings MUST EXIST IN HUBSPOT for the given object type (Order, Product etc).

### Addresses

[](#addresses)

Craft 4 changes the way addresses work for Users.

If you would like customer address information to be synced to Hubspot, make sure you follow the [Commerce Upgrade Guide](https://craftcms.com/docs/commerce/4.x/upgrading.html#performing-the-upgrade)and the [Craft Setup Guide](https://craftcms.com/docs/4.x/addresses.html#setup-pro) and have all address related configuration configured on your site.

Using HubSpot Commerce
----------------------

[](#using-hubspot-commerce)

The sync will happen automatically.

Synced item can be monitored from the Queue in Craft.

You are also able to manually sync data of a given type within a given date range. You can do this by heading to `Hubspot Commerce -> Manual Sync` from within the control panel and run any of the available syncs.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~35 days

Recently: every ~6 days

Total

20

Last Release

995d ago

Major Versions

1.14.0 → 2.0.02023-07-27

### Community

Maintainers

![](https://www.gravatar.com/avatar/f413fb5cce9ee64c968f0a296bdc43e07f5b3468f17b8a4d9d8c1e18959fb93d?d=identicon)[batch](/maintainers/batch)

---

Top Contributors

[![danielsiemers](https://avatars.githubusercontent.com/u/49675893?v=4)](https://github.com/danielsiemers "danielsiemers (130 commits)")

---

Tags

cmsCraftcraftcmscraft-pluginhubspot commerce

###  Code Quality

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/batchnz-hub-spot-ecommerce-bridge/health.svg)

```
[![Health](https://phpackages.com/badges/batchnz-hub-spot-ecommerce-bridge/health.svg)](https://phpackages.com/packages/batchnz-hub-spot-ecommerce-bridge)
```

###  Alternatives

[wrav/oembed

A simple plugin to extract media information from websites, like youtube videos, twitter statuses or blog articles.

36205.0k3](/packages/wrav-oembed)[craftpulse/craft-typesense

Craft Plugin that synchronises with Typesense

122.7k](/packages/craftpulse-craft-typesense)[jsmrtn/craftagram

Grab Instagram content through the Instagram API

141.3k](/packages/jsmrtn-craftagram)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
