Install the app
1
Open the listing
Find User Intuition in the HubSpot Marketplace (or use the install link from your team) and click Install.
2
Choose your portal
Select the HubSpot account to connect. You must be an admin of that portal.
3
Authorize the requested scopes
The app requests read access to contacts, companies, and deals, plus permission to show its card on CRM records. Click Connect app.
4
Land in User Intuition
You’re signed in to User Intuition and land on Create Study. If your HubSpot email already has a User Intuition account, that account is linked. Otherwise a new one is created.
5
Run the first sync
A default All Contacts segment is created automatically. Start the first sync from the User Intuition card on any HubSpot record or from the app settings page.
Invite HubSpot contacts to a study
1
Open Send Email Invites
On the study’s Invites tab, click Invite Participants → Send Email Invites.
2
Select the HubSpot connection
Click the HubSpot card at the top of the panel. It shows the sync status and how many contacts are available.
3
Pick contacts or segments
Use the Contacts tab to search by name, email, or phone, or the Segments tab to pick whole segments (each shows its customer count).
4
Send
Click Send N Invitations (or Send to N Segments). Contacts without an email address are skipped, and anyone already invited to this study isn’t invited again.
Interview a cohort from your agent
To run win-loss interviews on recently closed deals, use therun-win-loss skill in Claude, ChatGPT, Codex, or Cursor.
Your agent finds the people with the HubSpot or CRM tools it already has, shows you the list with a proposed cap (25 by default, at most 100 per batch), and invites only the batch you approve to a BYOP study. Each invite carries the HubSpot contact ID as its external ID, plus a few short attributes as interview context. Each run is a single batch your agent sends after you approve it. Nothing is sent automatically when a new event happens. See the cohort invite policy for the full rules.
In the app, you can do the same by hand: in HubSpot, build a list of the buyer contacts on deals closed won or lost in your window, start a sync, and pick that list from the Segments tab under Send Email Invites.
What you see in HubSpot
CRM record cards
A User Intuition card appears on contact, company, and deal records in HubSpot. It shows:- The portal’s sync state (idle, syncing, completed, or error)
- How many contacts have been imported
- A button to start a sync
- A link to your User Intuition workspace
App settings page
Open the User Intuition app from Settings → Integrations → Connected apps in HubSpot. Use this page to see the portal’s sync status, start a full sync, or open your User Intuition workspace.What syncs
Data flows one way, from HubSpot into User Intuition. Interview data isn’t written back to HubSpot.
Companies and deals aren’t imported as separate records. You invite their associated contacts.
Start a sync
You can start a sync from:- The User Intuition card on any HubSpot record
- The User Intuition settings page in HubSpot
- The re-sync button on the HubSpot connection card in User Intuition’s invite panel (shown once the status is COMPLETE or FAILED)
Automatic updates
New contacts and contact property changes in HubSpot flow into User Intuition automatically. Changes to properties outside those events are picked up on the next full sync, so run one occasionally as a backstop.Uninstall the app
Uninstalling the app from HubSpot disconnects the portal and stops updates from flowing into User Intuition. Studies, invites, and interviews you’ve already run stay in your workspace. Reconnecting later starts fresh and re-runs the full sync. On a large portal, plan it for a quiet window.Pitfalls and known limits
Admin install only
Installing requires HubSpot admin permissions on the portal. If install fails, check the installer’s role.
One portal per account
A User Intuition account links to one HubSpot portal. Connecting a different portal replaces the existing link.
Next steps
Shopify
Invite your store’s customers the same way
Send email invites
Manual entry, contacts, segments, and tracking

