HubSpot setup guide
Mobly's HubSpot integration syncs every captured-and-enriched lead into your HubSpot Contacts (and optionally Companies), with field mapping, qualifier mapping, and per-event campaign sync. Connection runs through Mobly's new integration platform, so there's no Connected App or API key to manage on your side.
What you can do
Sync leads to HubSpot Contacts — every Mobly-captured lead becomes a Contact in HubSpot, matched by Contact ID or Email (creates a new Contact if no match)
Sync to Companies — Mobly creates or updates the lead's Company by domain or company name
Map any Mobly field to any HubSpot property — including custom properties
Use HubSpot picklists for qualifier mapping — single-select and multi-select properties both work
Log lead activities as HubSpot Engagements — outreach actions in Mobly (Pulse sequence emails, calls, meetings, LinkedIn touches, SMS, manual notes) appear on the matching Contact as Email, Call, or Meeting engagements. See Finding Mobly activities in your CRM for the per-action breakdown
Sync to HubSpot Marketing Events — see Connecting HubSpot Marketing Events to Mobly Events for per-event campaign sync configuration
Toggle Automatic vs Manual sync — see Sync modes
What's not supported (yet)
Custom HubSpot objects other than Contact and Company aren't currently mapped from Mobly
Deal sync — Mobly doesn't create or update Deals; only Contact + Company. If you need lead-to-deal automation, build it in HubSpot using a workflow keyed off the Mobly-created Contact
Multi-integration — running HubSpot alongside another CRM in the same Mobly org isn't supported today (one CRM per org)
Before you connect
You'll need:
A HubSpot user with admin access (or at minimum, write access to Contacts and Companies, plus read access to your Marketing Events if you'll use campaign sync)
A Mobly admin account to view and configure Integrations
About 15 minutes for setup if your HubSpot properties are already in good shape
If your HubSpot has very lightly customized properties, plan extra time to align Mobly fields to existing HubSpot properties (or create new HubSpot properties for Mobly-specific fields like enrichment metadata).
Connect the integration
Go to Integrations → HubSpot in Mobly
Click Connect on the Connect tab
Sign in to HubSpot when prompted, pick the right HubSpot account if you have access to multiple, and approve the requested permissions
Detailed walkthrough of the Connect flow: see Connecting your CRM.
After connecting, the Connect tab will show your HubSpot account as Connected with a globe icon.
Configure data flow
Work through the tabs in order:
Mapping — match Mobly fields to HubSpot properties for Persona (Contact) and Company. Use Set Defaults for a quick start.
Qualifiers — define qualifiers and map values to HubSpot picklist options.
Campaigns — link Mobly events to HubSpot Marketing Events if you use them.
Sync mode — Automatic by default; switch to Manual on the Connect tab if needed.
HubSpot-specific configuration tips
Property types matter. Mobly's field type badges (TEXT, EMAIL, URL, PHONE) should align with HubSpot property types. Misaligned types most often surface as DATA_FORMAT_VALIDATION errors in Reconciliation.
Multi-select vs single-select. HubSpot's multi-select dropdowns accept multiple Mobly qualifier values when joined by your event name separator. Single-select dropdowns reject multi-value sends — use them only for Mobly qualifiers configured as Single.
"Restrict to Picklist Values" in Mobly qualifier mapping. When mapping a Mobly qualifier to a HubSpot picklist, every Mobly qualifier value needs a corresponding picklist option in HubSpot. Unmapped values trigger NO_TAG_MAPPING errors in Reconciliation.
Using open-text fields for qualifier flexibility. If your HubSpot picklists change frequently and rigid mapping is painful, map qualifiers to HubSpot open-text properties instead. Less validation, more flexibility.
Creating Mobly-specific properties. A common pattern is a "Mobly" group of properties in HubSpot — Mobly First Capture Date, Mobly Event, Mobly Booth Scan Count, etc. Create them in HubSpot → Settings → Properties → Create property before mapping in Mobly.
Troubleshooting
If a synced lead shows up in Reconciliation → Failed, see Fixing HubSpot sync errors — there's a section per error category with the fix.
For broader integration questions (auth, permissions, what data lands where), revisit Connecting your CRM and How data flows from Mobly to your CRM.
Related articles
Last updated
Was this helpful?