Integration Guide: HubSpot

Published Date: May 28, 2026 | Last Updated: October 9, 2026

Overview

The HubSpot integration connects Seasoft Identity to the organization’s HubSpot portal via OAuth, allowing Seasoft Identity to monitor and manage user access across the HubSpot environment. No API key is required — authorization is completed by signing in to HubSpot directly.

Before connecting

The Administrator completing the connection must have a Super Admin account in HubSpot.

Connect HubSpot

1. Navigate to Integrations in the left navigation.
2. Select + Add Integration.
3. Search for HubSpot and select Add.
4. Select Login to HubSpot. The Administrator is redirected to HubSpot to authorize access.
5. On the HubSpot authorization page, select the HubSpot portal to connect and select Choose Account.
6. After authorization is complete, Seasoft Identity displays a Connection Established confirmation showing the portal name, connected account, and connection timestamp. Select Done. The integration appears on the Integrations page and an initial sync begins automatically.

Verify the connection

After the initial sync completes, confirm the following on the Integrations page:

• The HubSpot integration displays a status of Active
• A sync timestamp is present and reflects the completed sync
• User records on the Users page display detected HubSpot permissions in the Access column

Reauthorizing the connection

If the HubSpot integration loses authorization, it will display an error on the Integrations page. To reauthorize, select the integration row, select Configure, and complete the authorization flow again using a valid Super Admin account.

Related articles

• Configuring Integrations — manage sync schedules, drift detection, and integration settings
• Understanding Errors — resolve integration errors and authorization failures