HubSpot Integration
Connect your HubSpot portal to LeadFuel for automatic contact matching, activity logging, and pushing AI-generated insights to custom properties.
Before You Start
- A LeadFuel account with Pro or Enterprise plan
- A HubSpot account with admin access
Navigate to Integration Settings
Log in to your LeadFuel dashboard and go to Settings → Integrations. In the CRM Provider section, select HubSpot.
The HubSpot section shows one of two ways to connect: a Connect HubSpot button, or Connect with a HubSpot access token. Follow the step below that matches what you see.
Connect HubSpot
If you see the Connect HubSpot button: click it. HubSpot opens so you can sign in, pick the portal, and approve LeadFuel. LeadFuel requests the CRM scopes it needs (contacts, companies, owners, tasks). List and deal scopes are optional and are granted when your HubSpot plan includes those tools.
If you see Connect with a HubSpot access token:
- 1In HubSpot, go to Development → Legacy apps, click Create legacy app, and choose Private
- 2On the Scopes tab, add every scope listed on the LeadFuel settings page
- 3Click Create app, open the Auth tab, and copy the access token
- 4Paste the token into LeadFuel and click Save Changes
Either way, the person connecting needs Super Admin access in HubSpot (Marketplace Access is also enough for the Connect HubSpot button).
Confirm the connection
With the Connect HubSpot button, HubSpot sends you back to LeadFuel after you approve access and you'll see a Connected status next to the button.
With an access token, the field shows Saved once you click Save Changes.
Test the Connection
Click the Test Connection button. LeadFuel will authenticate with HubSpot using your connection.
If successful, you'll see a green confirmation message showing your HubSpot portal name. If it fails, reconnect: click Reconnect HubSpot and approve the app again, or paste a current access token and save.
Configure CRM Field Mappings (Optional)
To push LeadFuel data (lead grades, AI summaries, pain points) to HubSpot custom properties:
- 1Scroll to the CRM Field Mapping section
- 2For each field you want to sync, enter the HubSpot property name
- 3Enable the toggle for each field
- 4Click Save Mappings
You'll need to create the custom properties in HubSpot first: Settings → Properties → Contact Properties → Create property.
Recommended property names: leadfuel_grade, leadfuel_score, leadfuel_summary, leadfuel_pain_points, leadfuel_event.
Use the internal property name (lowercase with underscores), not the display label. You can find the internal name in HubSpot under Settings → Properties → click the property → Internal name.
How Matching Works
When LeadFuel processes a lead, the HubSpot integration runs this matching logic:
Contact matching:
1. Search by email (if available) — exact match
2. Search by first name + last name — exact match
3. If no match found, the lead processes without a HubSpot link
Company matching:
1. Search by company name — token match (partial matching)
2. If found, the Contact is associated with the Company
Activity Logging:
Verify It's Working
After processing your first few leads, verify the integration is working:
- 1Open a processed lead in your LeadFuel dashboard
- 2Look for the CRM section — you should see a Contact ID and Account ID
- 3Open the Contact in HubSpot and verify:
- 4 - A completed task was logged with conversation notes
- 5 - If you configured field mappings, custom properties have LeadFuel data