Last updated
November 12th, 2026

HubSpot Setup

HubSpot connects to WorkSights through OAuth. Once connected, HubSpot sends events to WorkSights as they happen, and an hourly sweep runs in the background to catch anything webhooks may have missed.

WorkSights supports multiple HubSpot accounts. To connect more than one, use the Add Additional option after the first connection is complete.

Only Owners, Executives and Admins can connect services.

For an overview of how HubSpot activity appears in WorkSights, see HubSpot Integration Overview.

Connecting HubSpot

Step 1: Start the Connection

  1. Go to Services in the top navigation
  2. Find HubSpot in the list
  3. Click Connect HubSpot
HubSpot card on the WorkSights Connected Services page

Step 2: Authorize WorkSights in HubSpot

HubSpot asks you to select the account you want to connect. Choose the correct hub, then approve the requested permissions. The HubSpot user who authorizes the connection must have admin privileges in HubSpot. Without them, the connection cannot be completed.

To connect additional accounts, use the Add Additional button on the HubSpot integration page.

HubSpot opened from the WorkSights Connected Services grid, with the connected account and enabled features

Step 3: User Mapping

WorkSights imports your HubSpot users and matches them to WorkSights profiles by email. Open the Users tab to review the mappings. For any user that did not map automatically, select the correct WorkSights profile from the dropdown.

Users tab of the HubSpot service in WorkSights showing remote user mapping

Only mapped users generate timeline activity in WorkSights.

Step 4: Feature Subscriptions

Open the Features tab to confirm the relevant features are active. CRM, Sales, Service and Engagement are managed separately. A user needs the corresponding feature enabled to generate activity for that area of HubSpot.

What Happens Next

Once connected and users are mapped, WorkSights begins receiving HubSpot activity. On first connect, WorkSights also backfills the last 30 days of CRM data, so historical contact, company, deal and ticket activity fills in over the first processing cycles. Engagements are backfilled too: for the first 7 days after connecting, WorkSights sweeps the previous 30 days of engagement activity.

Overview tab of the HubSpot service in WorkSights

Activity appears on the timeline within about 20 minutes of occurring. You can review and update connection settings, user mappings and feature subscriptions at any time from the integration page.

Related Guides

HubSpot Integration Overview

CRM

Sales

Service

Engagement