Home
Expertise
Industries We Serve
Services
FAQs
Pumex Logo
DrupalBridge logo

Installation Guide

DrupalBridge Installation Guide

Follow these steps to connect your Drupal site to HubSpot using the DrupalBridge module.

Before You Begin

Prerequisites

01

Download DrupalBridge

Download the latest DrupalBridge module ZIP file from the official repository:

git.drupalcode.org/project/drupalbridge (v1.0.0-beta1)

  1. 1Click Code → zip inside the Download Source Code section.
  2. 2Extract the ZIP file. You should see a folder named "drupalbridge-1.0.0-beta1".
02

Copy Module into Drupal

Locate your Drupal installation folder and navigate to:

/web/modules/custom/
Note:If the custom folder does not exist, create it.

Copy the extracted folder into custom and rename it to "drupalbridge":

/web/modules/custom/drupalbridge
03

Enable the Module

  1. 1Log in to your Drupal admin panel.
  2. 2Go to: /admin/modules
  3. 3Search for: DrupalBridge
  4. 4Enable the checkbox beside the module.
  5. 5Click Install — DrupalBridge is now enabled.
DrupalBridge appearing in the Modules list under Web services
DrupalBridge appearing in the Modules list under Web services
04

Connect to HubSpot

Navigate to the DrupalBridge configuration page:

/admin/config/services/drupalbridge
DrupalBridge Settings page — showing the Connect to HubSpot button
DrupalBridge Settings page — showing the Connect to HubSpot button
  1. 1Click "Connect to HubSpot."
  2. 2You will be redirected to the HubSpot OAuth authorization screen.
  3. 3Select the HubSpot account you want to connect.
HubSpot account selection screen
HubSpot account selection screen
05

HubSpot Consent & Licence

  1. 1On the HubSpot consent screen, review the requested permissions and click "Connect app."
HubSpot consent screen listing requested permissions
HubSpot consent screen listing requested permissions
  1. 1HubSpot redirects you to the Drupal Registration Page.
  2. 2Complete the form (Full name, Email, Company) to receive your Licence Key.
Registration form — complete to receive your licence key
Registration form — complete to receive your licence key
  1. 1Click "Continue to Drupal Site" (or "Upgrade plan" to change your subscription).
  2. 2Copy your Licence Key from the confirmation screen.
Licence key confirmation screen
Licence key confirmation screen
  1. 1Back in DrupalBridge Settings, paste your Licence Key and save.
  2. 2You should now see: ✅ Connected to HubSpot! Portal ID: XXXXXX
DrupalBridge Settings showing successful HubSpot connection
DrupalBridge Settings showing successful HubSpot connection
06

Add Handler to the Webform

  1. 1Go to Webform in the Drupal admin.
  2. 2Select the form you want to connect.
  3. 3Navigate to Settings → Handlers.
  4. 4Click + Add handler.
Webform Emails/Handlers tab — click + Add handler
Webform Emails/Handlers tab — click + Add handler
  1. 1Select "DrupalBridge HubSpot" from the handler list and click Add handler.
  2. 2Save.
Select a handler modal — choose DrupalBridge HubSpot
Select a handler modal — choose DrupalBridge HubSpot
07

Configure Field Mapping

Navigate to the field mapping configuration page:

/admin/config/services/drupalbridge/field-mapping

Drupal fields are automatically loaded from your webforms, and HubSpot properties are fetched from your portal. Map the fields as follows:

Drupal FieldHubSpot Property
Email (email)Email (text)
First Name (first_name)First Name (text)
Last Name (last_name)Last Name (text)
Field Mapping UI — map Drupal fields to HubSpot properties
Field Mapping UI — map Drupal fields to HubSpot properties
  1. 1Click Save.
08

Submit a Test Form

Test the integration by submitting a form:

https://drupalbridge.ddev.site/form/{form_name}
Drupal test webform — fill in and submit
Drupal test webform — fill in and submit
  1. 1Fill in the form fields and click Submit.
Form submission confirmation screen
Form submission confirmation screen
  1. 1Open your HubSpot portal and verify that a new contact was created.
  2. 2If the contact appears, the connector is successfully installed. 🎉
HubSpot Contacts list — confirming the new contact was synced
HubSpot Contacts list — confirming the new contact was synced

Need help? Contact the Pumex Infotech support team at hubspot@pumexinfotech.com or visit pumexinfotech.com.