
Table of contents
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
- Go to Services in the top navigation
- Find HubSpot in the list
- Click Connect HubSpot

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.

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.

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.

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.