HubSpot Admin Setup Guide
A guide for your HubSpot administrator to connect LeadFuel via OAuth, 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 in HubSpot
LeadFuel authenticates with HubSpot using OAuth. A HubSpot Super Admin (or a user with Marketplace Access) authorizes LeadFuel from the LeadFuel dashboard — there is no Private App or token to copy.
- 1In LeadFuel, go to Settings → Integrations
- 2Select HubSpot as the CRM provider
- 3Click Connect HubSpot
- 4Sign in to HubSpot, choose the portal, and approve the requested scopes
- 5Click Test Connection back in LeadFuel
If your team previously pasted a Private App token, it still works as a fallback. Click Connect HubSpot when you are ready to upgrade.
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
- 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