HubSpot Admin Setup Guide
A guide for your HubSpot administrator to create a Private App, set up custom properties, and prepare your account for LeadFuel integration.
Before You Start
- HubSpot Super Admin access
- A LeadFuel account with CRM integration enabled (Pro or Enterprise plan)
Create a Private App
LeadFuel authenticates with HubSpot using a Private App access token.
- 1Go to Settings → Integrations → Private Apps
- 2Click Create a private app
- 3Name:
LeadFuel - 4Go to the Scopes tab and enable:
- 5 -
crm.objects.contacts.readandcrm.objects.contacts.write - 6 -
crm.objects.companies.read - 7 -
crm.objects.owners.read - 8 -
crm.lists.readandcrm.lists.write - 9Click Create app
- 10Copy the Access token — your LeadFuel admin will enter this in Settings → Integrations
The access token is shown only once when the app is created. Copy it immediately. If you lose it, you can rotate the token from the Private App settings.
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 the Private App and properties are created:
- 1Your LeadFuel admin goes to Settings → Integrations
- 2Select HubSpot as the CRM provider
- 3Paste the Private App access token from Step 1
- 4Click Test Connection to verify
- 5Configure field mappings in CRM Field Sync
- 6Click 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