Skip to main content

HubSpot Integration

Automatically capture WiFi guest information from your captive portal and sync contacts to HubSpot CRM for lead generation and marketing automation workflows.

Overview​

The HubSpot integration enables:

  • Contact sync from captive portal signups
  • Lead capture from WiFi guests
  • Marketing automation triggers
  • Customer tracking across touchpoints

Prerequisites​

  • IronWifi account with captive portal configured
  • HubSpot account (Free, Starter, or higher)
  • HubSpot API access

HubSpot Setup​

Get API Key​

  1. Log in to HubSpot
  2. Click Settings (gear icon)
  3. Go to Integrations > Private Apps
  4. Click Create a private app
  5. Configure:
    • Name: IronWifi Integration
    • Scopes: Select required permissions:
      • crm.objects.contacts.read
      • crm.objects.contacts.write
      • crm.lists.read
      • crm.lists.write
  6. Create app and copy the Access Token

IronWifi Configuration​

Step 1: Add HubSpot Integration​

  1. Log in to IronWifi Console
  2. Navigate to Networks > Captive Portals
  3. Select your captive portal
  4. Go to Integrations tab
  5. Click Add Integration > HubSpot

Step 2: Configure Connection​

Enter HubSpot credentials:

  • API Token: Your HubSpot private app token
  • Portal ID: Your HubSpot portal ID (found in account settings)

Step 3: Field Mapping​

Map captive portal fields to HubSpot contact properties:

Portal FieldHubSpot Property
Emailemail
First Namefirstname
Last Namelastname
Phonephone
Companycompany
Locationwifi_location (custom)
Visit Datelast_wifi_visit (custom)

Step 4: Sync Settings​

Options:

  • Create Contacts: Create new contacts for new guests
  • Update Existing: Update contact if email exists
  • Add to List: Automatically add to HubSpot list
  • Sync Frequency: Real-time or batched

Data Flow​

Guest Signup Flow​

  1. Guest connects to WiFi
  2. Enters information on captive portal
  3. Data sent to IronWifi
  4. IronWifi syncs to HubSpot
  5. Contact created/updated
  6. Added to WiFi guests list
  7. Marketing automation triggers

Captured Data​

Standard fields available:

  • Email address
  • Name
  • Phone number
  • Company (if collected)
  • WiFi location
  • Timestamp
  • Authentication method used

HubSpot Lists​

Create WiFi Guest List​

  1. In HubSpot, go to Contacts > Lists
  2. Create new list: "WiFi Guests"
  3. Note the list ID
  4. Configure IronWifi to add contacts to this list

Segmentation​

Create segments for targeted marketing:

  • Recent Visitors: Visited in last 30 days
  • Repeat Visitors: More than 3 visits
  • Location-Based: By WiFi location
  • High Engagement: Long session times

Marketing Automation​

Workflows​

Create HubSpot workflows triggered by WiFi signup:

Welcome Workflow:

  1. Trigger: Added to WiFi Guests list
  2. Send welcome email
  3. Wait 1 day
  4. Send special offer
  5. Add to nurture sequence

Re-engagement:

  1. Trigger: No visit in 30 days
  2. Send "We miss you" email
  3. Include return incentive

Email Templates​

Welcome Email:

Subject: Welcome to {{location}}!

Hi {{firstname}},

Thanks for visiting! We hope you enjoyed your time.

Here's a special offer for your next visit: [OFFER]

See you soon!

Custom Properties​

Create Custom Properties in HubSpot​

For WiFi-specific data:

  1. Go to Settings > Properties
  2. Click Create property
  3. Create:
    • wifi_location (Single-line text)
    • wifi_visits (Number)
    • last_wifi_visit (Date)
    • total_wifi_time (Number - minutes)

Map in IronWifi​

Configure field mapping to use custom properties.

Analytics​

HubSpot Reports​

Track WiFi guest metrics:

  • New contacts from WiFi
  • Conversion rate to customers
  • Email engagement
  • Return visit rate

Dashboard​

Create HubSpot dashboard:

  • WiFi signups over time
  • Top locations
  • Conversion funnel
  • ROI tracking

Troubleshooting​

Contacts Not Syncing​

  1. Verify API token is valid
  2. Check required scopes are enabled
  3. Review IronWifi sync logs
  4. Test API connection

Duplicate Contacts​

  1. Enable Update Existing option
  2. Use email as unique identifier
  3. Review HubSpot duplicate management

Fields Not Mapping​

  1. Verify HubSpot property exists
  2. Check property type matches data
  3. Review field mapping configuration

Privacy Compliance​

GDPR Considerations​

  1. Consent: Collect consent on captive portal
  2. Purpose: Clearly state data usage
  3. Data Access: Allow users to request data
  4. Deletion: Process deletion requests

HubSpot GDPR Tools​

  • Use HubSpot's consent management
  • Enable GDPR-compliant forms
  • Configure data retention policies

Best Practices​

  1. Collect consent before marketing emails
  2. Use double opt-in when possible
  3. Segment carefully for relevant messaging
  4. Monitor deliverability of emails
  5. Respect opt-outs promptly