Hubspot configuration guide
Overview
The HubSpot integration synchronizes guest contact information from GoZone into HubSpot contact records.
Key features:
- Create or update HubSpot contacts automatically
- Map GoZone profile fields to HubSpot contact properties
- Create multiple synchronization rules
- Restrict synchronization to specific hotspots
- Modify mappings at any time
- Reconnect or disconnect HubSpot without recreating rules
Note: Email addresses are always synced to the HubSpot Email property and cannot be changed.
Accessing the HubSpot Integration
- Navigate to Integrations from the left-side menu.
- Locate the HubSpot integration card.
- Click Add to create a new synchronization rule.
Creating a New Sync Rule
Step 1: Connect HubSpot
- Click Connect HubSpot.
- Sign in to your HubSpot account when prompted.
- Authorize the GoZone application.
- After authorization is complete, return to the rule configuration window.
Step 2: Enable the Rule
Ensure the Enabled option is selected.
Disabled rules will not synchronize any guest data to HubSpot.
Step 3: Configure Contact Field Mapping
Field mapping determines which GoZone guest profile fields are sent to specific HubSpot contact properties.
Adding a Mapping
- Select a HubSpot property from the left dropdown.
- Select a GoZone profile field from the right dropdown.
- Repeat for additional fields as needed.
- Click Add Mapping to create additional rows.
Available GoZone Profile Fields
The following profile fields are available for mapping:
| GoZone Field | Description |
|---|---|
| firstname | First Name |
| lastname | Last Name |
| mobilephone | Mobile Phone Number |
| birthdate | Birth Date |
| gender | Gender |
| address | Street Address |
| address2 | Address Line 2 |
| city | City |
| region | State / Region |
| country | Country |
| postal_code | Postal Code |
| hotspot_name | Name of the Connected Hotspot |
| total_connections | Total Wi-Fi Sessions |
| last_connection_time | Most Recent Wi-Fi Connection |
| custom1 | Custom Profile Field 1 |
| custom2 | Custom Profile Field 2 |
| custom3 | Custom Profile Field 3 |
| custom4 | Custom Profile Field 4 |
| custom5 | Custom Profile Field 5 |
| custom6 | Custom Profile Field 6 |
| custom7 | Custom Profile Field 7 |
| custom8 | Custom Profile Field 8 |
| custom9 | Custom Profile Field 9 |
| custom10 | Custom Profile Field 10 |
Step 4: Restricting Sync by Hotspot
Optionally, you can limit synchronization to specific hotspots.
- Locate the Hotspots field at the bottom of the rule.
- Select one or more hotspot locations.
- Only guests connecting through the selected hotspots will be synchronized to HubSpot.
Step 5: Saving the Rule
After configuring mappings:
- Verify all desired mappings are configured.
- Review selected hotspots (if applicable).
- Click Create Rule.
The rule will immediately become active if enabled.
Managing Existing Rules
To edit an existing sync rule:
- Open the HubSpot integration.
- Click Manage Rules.
- Select the rule you wish to modify.
From the rule editor, you can:
- Add new field mappings
- Remove existing mappings
- Modify hotspot restrictions
- Enable or disable the rule
- Save changes
Click Save Rule after making updates.
Reconnecting HubSpot
If the HubSpot authorization expires or the connected account changes:
- Open Manage Rules.
- Click Reconnect HubSpot.
- Complete the HubSpot authorization process.
Existing synchronization rules and mappings remain intact.
Disconnecting HubSpot
To completely remove the HubSpot connection:
- Open Manage Rules.
- Click Disconnect HubSpot.
Warning: Disconnecting HubSpot prevents all synchronization until a new connection is established.
Existing rules remain configured but will not process data while the integration is disconnected.
Best Practices
Map Only Required Data
Only map fields that your HubSpot workflows, lists, or reporting require.
Create Matching Custom Properties First
If mapping to custom HubSpot fields, create those properties in HubSpot before configuring the rule.
Use Hotspot Filtering for Multi-Location Deployments
Organizations with multiple venues can create separate rules for individual locations by leveraging hotspot restrictions.
Verify Test Contacts
After creating a rule, perform a test guest sign-in and confirm the contact appears in HubSpot with the expected field values.
Troubleshooting
Contacts Are Not Appearing in HubSpot
Verify:
- The rule is enabled
- HubSpot is connected
- The guest has a valid email address
- The guest connected through an allowed hotspot
- Field mappings are configured correctly
Data Is Missing from HubSpot
Verify:
- The corresponding GoZone profile field contains data
- The correct HubSpot property is selected
- Custom HubSpot properties exist and are available for mapping
HubSpot Connection Needs Attention
If the integration displays a connection warning:
- Open Manage Rules
- Click Reconnect HubSpot
- Re-authorize the HubSpot account
This will restore synchronization without requiring rule recreation.