Magento Community Edition

2.x (all minor versions are supported)

Magento Enterprise Edition

2.x (all minor versions are supported)


What you will need:


  1. FTP/SSH Credentials with READ/WRITE access to the Magento website.
  2. Magento Admin username and password.
  3. Magento Admin role needs to allow access to System Configuration (Admin role is fine).
  4. HubSpot Credentials.

Magento 2 Extension Installation Instructions:


  1. Download the file
  2. Launch an FTP/SSH Client and connect to the Magento website.
  3. Navigate to app/code under the web root of the Magento site.
  4. Unzip the HubSpot Extension and merge the folder. If you are using FTP,  please use "Merge" upload mode.
  5. Once the folders are merged, please make sure that there is a folder named Eyemagine/HubSpot located under app/code directory.
  6. Connect to your Magento directory and run the following commands.
  • php bin/magento module:enable Eyemagine_HubSpot

    php bin/magento setup:upgrade

Activation Instructions:


  1. Install the extension (instructions are provided above).
  2. Log into the Magento Admin
  3. Navigate to System > Cache Management.
  4. Check the Configuration cache type and submit the Refresh action.
  5. Log out (this updates ACL Roles allowing access to the HubSpot resource)
  6. Log in
  7. Navigate to Stores > Configuration > Services > HubSpot Integration
  8. Enable HubSpot and click the Save Config button.
  9. Take note of the User Key and Pass Code  
  10. You can always refresh the access keys, however, this will require updating the HubSpot App with the new values.

HubSpot App Configuration Instructions:


  1. Log into
  2. Click "Sign In With HubSpot"
  3. Enter your HubSpot portal ID
  4. Enter your Magento site URL (include the trailing slash "/")
  5. Paste in the values provided by the Magento extension for User Key and Pass Code
  6. Click Submit
  7. If you see a Subscribe Now button, click it to start your PayPal trial (free 30-day trial)
  8. Site data should begin syncing within a few hours, but depending on the size of the historical data it might take up to a day to fully sync to HubSpot.

Things to check after install:


  1. If you are using memcache or other data caching services, you will need to refresh it in addition to the Magento Cache.
  2. If you are using multiple servers (separate server for admin) make sure the extension is installed for all of the servers.

Keep in mind that after installation and payment subscription have been completed successfully, the portal will still need to be activated. Therefore, it can take up to one business day before contacts begin to be imported from Magento into HubSpot.