HubSpot Admin Setup Guide
A guide for your HubSpot administrator to connect LeadFuel, set up custom properties, and prepare your account for integration.
Before You Start
- HubSpot Super Admin access
- A LeadFuel account with CRM integration enabled (Pro or Enterprise plan)
Connect LeadFuel to HubSpot
In LeadFuel, go to Settings → Integrations and select HubSpot as the CRM provider. The HubSpot section shows one of two ways to connect. Use whichever one you see — both give LeadFuel the same access.
If you see the Connect HubSpot button: a HubSpot Super Admin (or a user with Marketplace Access) clicks it, signs in to HubSpot, chooses the portal, and approves the requested scopes. Then click Test Connection back in LeadFuel.
If you see Connect with a HubSpot access token: a HubSpot Super Admin creates a private app in your HubSpot account and pastes its token into LeadFuel.
- 1In HubSpot, go to Development → Legacy apps
- 2Click Create legacy app and choose Private
- 3Name it
LeadFuel - 4Open the Scopes tab, click Add new scope, and select every scope listed below
- 5Click Create app, then Continue creating
- 6Open the Auth tab, click Show token, and copy the access token
- 7In LeadFuel, paste the token into the Access token field and click Save Changes
- 8Click Test Connection
Scopes to select:
crm.objects.contacts.readcrm.objects.contacts.writecrm.objects.companies.readcrm.objects.companies.writecrm.objects.owners.readcrm.objects.tasks.readcrm.objects.tasks.writecrm.objects.deals.readcrm.lists.readcrm.lists.write
The last three (deals and lists) are optional — skip any that HubSpot doesn't offer in your account.
Don't trim the scope list. A missing scope doesn't fail the connection test — it shows up later as a 403 error when a real lead tries to create a company or log activity. Treat the token like a password: paste it only into LeadFuel's settings page.
Create Custom Properties on Contacts
LeadFuel pushes 14 properties to Contact records. Create a property group and properties:
- 1Go to Settings → Properties → Contact properties
- 2Click Create a group → name it
LeadFuel - 3Create these properties in the LeadFuel group:
| Property Label | Internal Name | Type |
|---|---|---|
| LeadFuel Grade | leadfuel_grade | Single-line text |
| LeadFuel Score | leadfuel_score | Number |
| LeadFuel Summary | leadfuel_summary | Multi-line text |
| LeadFuel Pain Points | leadfuel_pain_points | Multi-line text |
| LeadFuel Products Discussed | leadfuel_products_discussed | Multi-line text |
| LeadFuel Projects | leadfuel_projects | Multi-line text |
| LeadFuel Follow-Up Hook | leadfuel_followup_hook | Multi-line text |
| LeadFuel Email Subject | leadfuel_email_subject | Single-line text |
| LeadFuel Email Body | leadfuel_email_body | Multi-line text |
| LeadFuel Email Status | leadfuel_email_status | Single-line text |
| LeadFuel CRM Notes | leadfuel_crm_notes | Multi-line text |
| LeadFuel Event | leadfuel_event | Single-line text |
| LeadFuel Rep | leadfuel_rep | Single-line text |
| LeadFuel Tags | leadfuel_tags | Multi-line text |
Start with the core properties (Grade, Score, Summary, Pain Points) and add the rest later. LeadFuel skips any properties that don't exist yet.
Connect in LeadFuel
Once HubSpot is connected and properties are created:
- 1Confirm Settings → Integrations shows HubSpot as Connected, or the access token as Saved
- 2Click Test Connection to verify
- 3Configure field mappings in CRM Field Sync
- 4Click Save Mappings
Test the Integration
- 1In LeadFuel, click Test Connection — verify green confirmation
- 2Open any processed lead and click Sync to CRM
- 3In HubSpot, open the same Contact and verify the LeadFuel properties are populated
- 4Check that the LeadFuel property group appears on the Contact record sidebar