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 field for your HubSpot Private App Token.
Create a HubSpot Private App
In your HubSpot portal:
- 1Go to Settings → Integrations → Private Apps
- 2Click Create a private app
- 3Name it
LeadFuel - 4Under the Scopes tab, add these scopes:
- 5 -
crm.objects.contacts.read - 6 -
crm.objects.contacts.write - 7 -
crm.objects.companies.read - 8 -
crm.objects.owners.read - 9 -
crm.lists.read(for campaign attribution) - 10 -
crm.lists.write(for campaign attribution) - 11Click Create app
- 12Copy the Access Token shown on the confirmation screen
The access token is only shown once when the app is created. If you lose it, you can regenerate it from the Private App settings page in HubSpot.
Enter Your HubSpot Token
Back in LeadFuel Settings → Integrations → HubSpot:
- 1Paste the access token into the Private App Token field
- 2Click Save Changes
LeadFuel stores this token securely per-tenant — it's never shared with other accounts.
Test the Connection
After saving, click the Test Connection button. LeadFuel will attempt to authenticate with HubSpot using your token.
If successful, you'll see a green confirmation message showing your HubSpot portal name. If it fails, double-check: - The access token is correct (no extra spaces) - The Private App hasn't been deactivated in HubSpot - All required scopes are enabled on the Private App
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