====== Magento 2 HubSpot Connector Extension User Guide ======

===== Related overview =====

For a shopper-friendly overview of features and setup, see the [[https://toweringmedia.com/magento-2-hubspot-connector-user-guide|Magento 2 HubSpot Connector User Guide - Real-Time Customer & Order Sync]] on the storefront. This wiki page remains the full technical documentation.

===== Extension context =====

This is a Toweringmedia Magento 2 extension guide for the current admin extension catalog.

===== Product page =====

  * [[https://toweringmedia.com/magento-2-hubspot-connector-extension-for-real-time-customer-order-sync|Magento 2 HubSpot Connector Extension for Real-Time Customer & Order Sync]] (SKU ''Magento 2 HubSpot Connector Extension'')

===== Overview =====

This extension keeps Magento 2 customer and order data in sync with HubSpot. It connects over OAuth, pushes customer and order records into your HubSpot portal, and supports inbound webhooks so changes made in HubSpot can be reflected back. Debug logging is available for tracing individual sync operations.

===== What this extension does =====

  * Syncs Magento customers and orders into HubSpot.
  * OAuth connection using a HubSpot app client ID and client secret.
  * Optional inbound webhook handling from HubSpot.
  * Debug logging for tracing sync operations.

===== Requirements =====

  * Magento 2.4.x (Open Source or Adobe Commerce).
  * PHP: ^8.1 || ^8.2 || ^8.3 || ^8.4 (as declared by the published package).
  * A current Toweringmedia license and Composer credentials for ''https://composer.toweringmedia.com/''.
  * A HubSpot account and a HubSpot app configured to issue OAuth credentials.
  * Composer resolves ''toweringmedia/module-base'' automatically.

===== Installation =====

Install and validate in a staging environment before production rollout.

<code bash>
cd /path/to/magento
composer require toweringmedia/module-hubspot-integration

bin/magento module:enable Toweringmedia_HubspotIntegration
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush
</code>

Currently published versions at the time of writing:

  * ''toweringmedia/module-hubspot-integration'' — 1.0.4

Toweringmedia packages are served from the licensed Composer repository ''https://composer.toweringmedia.com/''. If Composer reports that the package could not be found, your credentials are missing or the license does not cover this package yet. Retrieve your keys from **My Account** on toweringmedia.com, or contact [[mailto:support@toweringmedia.com|support@toweringmedia.com]].

General installation notes that apply to every Toweringmedia extension are in the [[https://toweringmedia.com/installation|installation guide]].

==== Package naming note ====

The storefront product is named **HubSpot Connector**, but the Composer package is ''toweringmedia/module-hubspot-integration'' and the Magento module is ''Toweringmedia_HubspotIntegration''. The install command above uses the real package name.

===== Configuration =====

  * Stores > Configuration > Towering Media > **HubSpot Integration** (config section ''toweringmedia_hubspotintegration'').
  * Groups: ''general'' (enable, debug logging, webhook enable) and ''oauth'' (client ID, client secret).
  * Admin screen: Towering Media > Integrations & Feeds > **HubSpot Integration**.

===== Basic usage and what to expect =====

  - Create a HubSpot app, copy the client ID and client secret into the OAuth group, and complete the authorization.
  - Enable the integration, then create or edit a test customer and confirm the record appears in HubSpot.
  - Turn on debug logging temporarily if a record is not appearing, then turn it back off.

===== Validation checklist =====

  * ''bin/magento module:status'' shows the module(s) as enabled.
  * Extension configuration saves without errors in Admin.
  * The admin screens listed above are reachable and load without error.
  * Expected storefront/admin behavior is present after a cache flush.
  * No critical PHP/JS errors appear in ''var/log/'' during the primary test flow.

===== Troubleshooting =====

  * **Composer cannot find the package**: confirm the ''https://composer.toweringmedia.com/'' repository and your credentials are present in ''auth.json'', and that your license covers this package.
  * **Feature not visible**: verify module status, flush cache, and redeploy static content.
  * **Admin setting not applying**: clear cache and confirm the config scope (default / website / store view).
  * **Unexpected behavior**: retest with only the required related modules enabled.

===== Support =====

  * [[mailto:support@toweringmedia.com|support@toweringmedia.com]]
  * [[https://toweringmedia.com/magento-maintenance-support|Magento maintenance and support]]

===== Related Magento 2 docs =====

  * [[magento2:extensions:start|Magento 2 extension index]]
  * [[start|Global docs home]]