HubSpot Integration

Connect your HubSpot account to FluxCascade to sync contacts, companies, and deals with other platforms.

Overview

Getting Started

Prerequisites

Before connecting HubSpot, ensure you have:

• A HubSpot account (Free tier or higher)
• Admin or Super Admin permissions in HubSpot
• A FluxCascade account

Step 1: Connect Your Account

1. Go to Connections in FluxCascade
2. Click Add Connection
3. Select HubSpot from the list
4. Click Connect with HubSpot
5. Sign in to your HubSpot account if prompted
6. Review the permissions and click Connect app

FluxCascade will request the following scopes:

• crm.objects.contacts.read – Read contact data
• crm.objects.contacts.write – Create/update contacts
• crm.objects.companies.read – Read company data
• crm.objects.companies.write – Create/update companies
• crm.objects.deals.read – Read deal data
• crm.objects.deals.write – Create/update deals

Step 2: Verify Connection

After connecting, you'll see:

• Connected status with a green indicator
• The HubSpot portal name you connected
• Last sync time (if applicable)

Supported Objects

Contacts

HubSpot Contacts map to people records in other systems.

Standard Fields:

• firstname, lastname, email
• phone, mobilephone
• address, city, state, zip, country
• company, jobtitle
• lifecyclestage, hs_lead_status

Custom Properties:
All custom contact properties are automatically available for mapping.

Companies

HubSpot Companies map to organization/account records.

Standard Fields:

• name, domain
• phone, address, city, state, zip, country
• industry, numberofemployees, annualrevenue

Deals

HubSpot Deals map to opportunity/job records.

Standard Fields:

• dealname, amount, closedate
• dealstage, pipeline
• Associated contacts and companies

Field Mapping Examples

Contact to Jobber Client

Pipeline Stage Mapping

Map HubSpot deal stages to Jobber job statuses:

Real-time Webhooks

HubSpot supports real-time webhooks for instant sync triggers.

Supported Webhook Events

• Contact created/updated
• Company created/updated
• Deal created/updated
• Deal stage changed

Enabling Webhooks

1. In your mapping settings, enable Real-time sync
2. FluxCascade automatically registers webhooks with HubSpot
3. Changes in HubSpot trigger immediate syncs

Rate Limits

HubSpot enforces API rate limits. FluxCascade handles these automatically:

If limits are hit, FluxCascade will retry with exponential backoff.

Troubleshooting

Common Issues

"Insufficient permissions" error
Ensure your HubSpot user has Admin or Super Admin permissions.

"Rate limit exceeded" error
Wait a few seconds and try again. Consider reducing sync frequency.

Custom properties not showing
Refresh your connection to load new custom properties.

Reconnecting

If you need to refresh your connection:

1. Go to Connections
2. Find your HubSpot connection
3. Click Disconnect
4. Reconnect following the steps above

Next Steps

• Create a mapping between HubSpot and another platform
• Learn about field transformations
• Set up sync schedules