Skip to main content
The fsckmsft HubSpot connector is a certified, pre-built integration that keeps your HubSpot CRM and fsckmsft workspace synchronized. Contacts created in HubSpot appear in fsckmsft automatically, deals stay current across both platforms, and your sales and delivery teams stop chasing each other for updates.

​
Prerequisites

Before you connect HubSpot, confirm the following:
  • You have HubSpot Super Admin access (or a role with App Marketplace and API access permissions) in the HubSpot account you want to connect.
  • Your fsckmsft workspace is on the Pro or Business plan. The HubSpot connector is not available on the Free plan.
  • Your HubSpot account is on Starter, Professional, or Enterprise tier. Free HubSpot accounts have limited API access that may affect sync reliability.
You can connect one HubSpot account per fsckmsft workspace. To sync multiple HubSpot portals, use separate fsckmsft workspaces.

​
Connect HubSpot

1

Open Integrations settings

In your fsckmsft workspace, navigate to Settings → Integrations → Partner Connectors and click the HubSpot tile.
2

Authorize the connection

Click Connect HubSpot. You are redirected to the HubSpot OAuth consent screen. Sign in with your HubSpot Super Admin credentials, select the HubSpot portal to connect, and click Connect app.
3

Confirm the connection

After authorization, you are returned to fsckmsft. The connector settings page displays your HubSpot portal name and portal ID. The connection status shows Active.

​
Choose objects to sync

Select which HubSpot objects to sync and the direction of data flow.
HubSpot objectfsckmsft objectSync directions available
ContactsContactsHubSpot → fsckmsft, fsckmsft → HubSpot, Bidirectional
CompaniesOrganizationsHubSpot → fsckmsft, fsckmsft → HubSpot, Bidirectional
DealsDealsHubSpot → fsckmsft, fsckmsft → HubSpot, Bidirectional
1

Toggle on objects

Under Object Sync, enable the HubSpot objects you want to sync.
2

Set sync direction

For each object, choose the sync direction. Use Bidirectional only when both teams actively create and update records in their respective tools.
3

Apply list filters (optional)

For Contacts and Companies, optionally restrict the sync to a specific HubSpot Active List. Only records that are members of that list at sync time will be synced. Leave unset to sync all records.
Use a HubSpot Active List to sync only your highest-value records initially — for example, Contacts with a Lifecycle Stage of Customer — and broaden the filter once you have validated the sync.

​
Configure field mapping

Field mapping defines which HubSpot properties map to which fsckmsft fields.
1

Open Field Mapping

On the connector settings page, click Field Mapping next to the object you want to configure.
2

Review default mappings

fsckmsft pre-populates the following defaults:Contacts
HubSpot propertyfsckmsft field
firstname + lastnameFull Name
emailPrimary Email
phonePhone
companyOrganization (name)
jobtitleJob Title
Deals
HubSpot propertyfsckmsft field
dealnameDeal Name
amountValue
dealstageStage
closedateExpected Close Date
3

Add custom property mappings

Click Add Mapping to map HubSpot custom properties to fsckmsft custom fields. Both sides must have a matching field type (text, number, date, dropdown) for the mapping to save.
HubSpot calculated properties (e.g., num_associated_deals) are read-only and cannot be written back from fsckmsft. Map them as read-only fields to avoid sync errors.

​
Sync frequency

​
sync_frequency
string
required
How often the connector polls HubSpot for changes. Options: real-time (webhook-based, requires Professional or Enterprise HubSpot), every_15_minutes, every_hour, every_day.
Real-time sync uses the HubSpot Webhooks API to deliver changes within seconds of them occurring. Polling intervals are available for all HubSpot tiers.
The initial sync after connection ingests all existing records and may take 10–30 minutes depending on the size of your HubSpot portal. Monitor progress on the connector settings page.

​
Manage the connection

From Settings → Integrations → Partner Connectors → HubSpot, you can:
  • Pause sync — temporarily halt all sync activity without disconnecting. Useful when making bulk changes in one system that you do not want propagated.
  • Re-sync now — trigger an immediate full re-sync outside the normal schedule.
  • View sync history — inspect a log of every sync run, including record counts and any errors encountered.
  • Edit mappings — update field mappings at any time. Changes apply to the next sync run.

​
Disconnect HubSpot

1

Open connector settings

Go to Settings → Integrations → Partner Connectors → HubSpot.
2

Click Disconnect

Scroll to the bottom of the page and click Disconnect HubSpot.
3

Confirm

Click Disconnect in the confirmation dialog. All sync activity stops immediately and the OAuth token is revoked.
Disconnecting stops all future syncing but does not remove records that have already been synced into either system. Delete records manually if you need to clean up synced data after disconnecting.