Installation Guide
DrupalBridge Installation Guide
Follow these steps to connect your Drupal site to HubSpot using the DrupalBridge module.
Before You Begin
Prerequisites
- HubSpot Admin Account — A HubSpot account with admin access.
- Drupal 10+ — Drupal version 10 or higher installed (v11.3.5 recommended).
Download DrupalBridge
Download the latest DrupalBridge module ZIP file from the official repository:
git.drupalcode.org/project/drupalbridge (v1.0.0-beta1)
- 1Click Code → zip inside the Download Source Code section.
- 2Extract the ZIP file. You should see a folder named "drupalbridge-1.0.0-beta1".
Copy Module into Drupal
Locate your Drupal installation folder and navigate to:
/web/modules/custom/Copy the extracted folder into custom and rename it to "drupalbridge":
/web/modules/custom/drupalbridgeEnable the Module
- 1Log in to your Drupal admin panel.
- 2Go to: /admin/modules
- 3Search for: DrupalBridge
- 4Enable the checkbox beside the module.
- 5Click Install — DrupalBridge is now enabled.
Connect to HubSpot
Navigate to the DrupalBridge configuration page:
/admin/config/services/drupalbridge- 1Click "Connect to HubSpot."
- 2You will be redirected to the HubSpot OAuth authorization screen.
- 3Select the HubSpot account you want to connect.
HubSpot Consent & Licence
- 1On the HubSpot consent screen, review the requested permissions and click "Connect app."
- 1HubSpot redirects you to the Drupal Registration Page.
- 2Complete the form (Full name, Email, Company) to receive your Licence Key.
- 1Click "Continue to Drupal Site" (or "Upgrade plan" to change your subscription).
- 2Copy your Licence Key from the confirmation screen.
- 1Back in DrupalBridge Settings, paste your Licence Key and save.
- 2You should now see: ✅ Connected to HubSpot! Portal ID: XXXXXX
Add Handler to the Webform
- 1Go to Webform in the Drupal admin.
- 2Select the form you want to connect.
- 3Navigate to Settings → Handlers.
- 4Click + Add handler.
- 1Select "DrupalBridge HubSpot" from the handler list and click Add handler.
- 2Save.
Configure Field Mapping
Navigate to the field mapping configuration page:
/admin/config/services/drupalbridge/field-mappingDrupal fields are automatically loaded from your webforms, and HubSpot properties are fetched from your portal. Map the fields as follows:
- 1Click Save.
Submit a Test Form
Test the integration by submitting a form:
https://drupalbridge.ddev.site/form/{form_name}- 1Fill in the form fields and click Submit.
- 1Open your HubSpot portal and verify that a new contact was created.
- 2If the contact appears, the connector is successfully installed. 🎉
Need help? Contact the Pumex Infotech support team at hubspot@pumexinfotech.com or visit pumexinfotech.com.