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.
You'll see a Connect HubSpot button.
Connect HubSpot
Click Connect HubSpot. 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.
You do not create a Private App or copy a token.
The person who clicks Connect needs Super Admin or Marketplace Access in HubSpot.
Confirm the connection
After you approve access, HubSpot sends you back to LeadFuel. You should see a Connected status next to the Connect button.
Test the Connection
Click the Test Connection button. LeadFuel will authenticate with HubSpot using the OAuth connection.
If successful, you'll see a green confirmation message showing your HubSpot portal name. If it fails, click Reconnect HubSpot and approve the app again.
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