Skip to content
English
  • There are no suggestions because the search field is empty.

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
  1. Navigate to Integrations from the left-side menu.
  2. Locate the HubSpot integration card.
  3. Click Add to create a new synchronization rule.

Creating a New Sync Rule

Step 1: Connect HubSpot

  1. Click Connect HubSpot.
  2. Sign in to your HubSpot account when prompted.
  3. Authorize the GoZone application.
  4. 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
  1. Select a HubSpot property from the left dropdown.
  2. Select a GoZone profile field from the right dropdown.
  3. Repeat for additional fields as needed.
  4. 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.

  1. Locate the Hotspots field at the bottom of the rule.
  2. Select one or more hotspot locations.
  3. Only guests connecting through the selected hotspots will be synchronized to HubSpot.

Step 5: Saving the Rule

After configuring mappings:

  1. Verify all desired mappings are configured.
  2. Review selected hotspots (if applicable).
  3. Click Create Rule.

The rule will immediately become active if enabled.


Managing Existing Rules

To edit an existing sync rule:

  1. Open the HubSpot integration.
  2. Click Manage Rules.
  3. 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:

  1. Open Manage Rules.
  2. Click Reconnect HubSpot.
  3. Complete the HubSpot authorization process.

Existing synchronization rules and mappings remain intact.


Disconnecting HubSpot

To completely remove the HubSpot connection:

  1. Open Manage Rules.
  2. 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:

  1. Open Manage Rules
  2. Click Reconnect HubSpot
  3. Re-authorize the HubSpot account

This will restore synchronization without requiring rule recreation.