Skip to main content

​
Overview

Connecting HubSpot lets Wolfia tie each security questionnaire or RFP to the right company and deal, so answers draw on live account context and status updates flow back to the matching opportunity automatically.

​
Permissions by use case

Wolfia follows least privilege. Read access powers everything by default; write is used only if you enable the optional write-back feature. Wolfia never requests delete permissions on any object.
HubSpot OAuth grants the app’s scopes as a single approval, so the write scope appears in the consent screen even if you never enable write-back. With write-back off, Wolfia only reads.

​
Prerequisites

Before setting up the integration, you’ll need:
  • A HubSpot account with Admin or Super Admin access
  • Permission to approve OAuth integrations for your HubSpot portal

​
Setup instructions

​
Step 1: Open Wolfia integrations

  1. Log in to your Wolfia account
  2. Navigate to Trust Center → Integrations
  3. Find HubSpot in the list of available integrations

​
Step 2: Connect HubSpot

  1. Click Connect on the HubSpot integration card
  2. You’ll be redirected to HubSpot’s sign-in page
  3. Sign in with your HubSpot credentials (if not already signed in)

​
Step 3: Select your HubSpot account

If you have access to multiple HubSpot portals, select the account you want to connect to Wolfia.

​
Step 4: Approve permissions

HubSpot will display the permissions Wolfia is requesting; they match the Permissions by use case table above. Click Connect app to grant Wolfia access.

​
Step 5: Verify the connection

After approving, you’ll be redirected back to Wolfia.
  1. The HubSpot integration should now show as Connected in your integrations page
  2. Wolfia will begin the initial data sync automatically
  3. You can verify sync progress in the integration status panel

​
What happens after setup

Once connected, Wolfia will:
  • Import existing data: Sync your companies, deals, and contacts from HubSpot
  • Continuous sync: Automatically update when data changes in either system
  • Enrich context: Use HubSpot data to provide better responses to questionnaires
  • Update HubSpot (only if write-back is enabled): Write questionnaire status back to the matching company or deal

​
Managing the integration

​
Viewing sync status

Check the health and activity of your HubSpot integration:
  1. Navigate to Trust Center → Integrations
  2. Find HubSpot in the connected integrations
  3. View:
    • Last sync time
    • Number of synced records
    • Any sync errors or warnings

​
Pausing the integration

Temporarily disable syncing without removing the integration:
  1. Go to Trust Center → Integrations → HubSpot
  2. Toggle the Active switch to off
  3. Syncing will pause immediately
  4. Toggle back on to resume syncing

​
Disconnecting HubSpot

Remove the integration entirely:
  1. Go to Trust Center → Integrations → HubSpot
  2. Click Disconnect
  3. Confirm the disconnection
  4. The integration will be removed, but your data in both systems remains unchanged

​
Security considerations

  • The integration uses OAuth 2.0 for secure authentication: no API keys or tokens to manage
  • Read access is the default; Wolfia writes nothing unless you enable questionnaire write-back
  • All data transmission is encrypted using HTTPS
  • OAuth tokens are stored securely and never exposed in logs
  • No delete permissions to prevent accidental data loss
  • You can revoke access at any time from HubSpot Settings → Integrations → Connected Apps

​
Troubleshooting

​
Common issues

Connection failed
  • Ensure you have Admin or Super Admin access in HubSpot
  • Try disconnecting and reconnecting the integration
  • Check that your HubSpot account is active and in good standing
No data syncing
  • Verify the integration is active (not paused) in Wolfia settings
  • Check that you approved all requested permissions during the OAuth flow
  • Review the sync logs in Wolfia for specific error messages
Permission denied errors
  • Your HubSpot account may not have sufficient permissions
  • Try disconnecting and reconnecting; you’ll be prompted to approve permissions again
  • Contact your HubSpot administrator to verify your role has the required access
Sync delays
  • HubSpot syncs run periodically (typically daily)
  • Large data sets may take longer to complete the initial sync
  • Check the last sync time in Wolfia’s integration settings

​
Reconnecting the integration

If you need to refresh the connection (e.g., after changing HubSpot permissions or accounts):
  1. Go to Trust Center → Integrations → HubSpot
  2. Click Disconnect to remove the current connection
  3. Click Connect to start the OAuth flow again
  4. Approve the requested permissions
  5. Data syncing will resume with the new connection

​
Support

If you encounter any issues during setup, please contact Wolfia support at support@wolfia.com or consult your HubSpot administrator for assistance with permissions.