HubSpot

Connect a production HubSpot account with Contrast OAuth and verify the first warehouse sync.

Connect HubSpot in about five minutes. Contrast uses its existing OAuth app, so you do not create a private app, copy an access token, or find Contrast in the HubSpot Marketplace.

Have an agent set it up instead:

No private app is required

Contrast uses HubSpot OAuth for customer installations. HubSpot may show an unverified-app warning while the app is not listed in its Marketplace. Confirm the app is Contrast Warehouse Ingestion, review the requested read access, then follow HubSpot's confirmation steps. A Marketplace listing is not required for this OAuth connection to work.

Before you start

You need:

  • A Contrast workspace administrator
  • A HubSpot Super Admin, or a user with HubSpot Marketplace Access and permission to the CRM data being connected
  • The name of the production HubSpot account to connect

The HubSpot user is needed only to approve the connection. Contrast does not store that user's password.

Connect HubSpot

Open HubSpot in Contrast

Open Warehouse → Ingestion. Select Connect warehouse source for the first source, or New sync if the workspace already has ingestion syncs. Find HubSpot and select Connect.

Choose the production account

HubSpot lists the accounts the signed-in user can access. Select the production account, then select Choose Account. If the account is missing, sign in as a HubSpot Super Admin or ask an admin to grant HubSpot Marketplace Access and the required CRM permissions.

Review and approve access

Contrast requires read access to contacts, companies, and deals. It also requests optional read access for data such as tickets, owners, products, line items, quotes, and custom objects. HubSpot leaves out optional access that the account's plan or the installing user cannot grant.

If HubSpot shows an unverified-app warning, confirm the app is Contrast Warehouse Ingestion and the permissions are read access described above. Then select Connect app.

Choose tables and start the sync

HubSpot returns you to Contrast and catalog discovery begins. Start with contacts, companies, and deals. Keep the suggested columns selected, choose the destination database, run validation, and select Start sync.

Optional tables appear only when HubSpot granted their access. This does not block the three core tables.

Verify the connection

Setup is complete when:

  1. The run shows Succeeded.
  2. The destination has the expected HubSpot records.
  3. A second run succeeds without duplicating existing rows.

Contrast then continues from its saved HubSpot cursor. Archived HubSpot records are kept as deletion markers in the warehouse.

What Contrast can sync

AccessData
RequiredContacts, companies, and deals
OptionalTickets, owners, products, line items, quotes, and custom objects
Discovered automaticallyAvailable activities, pipelines, stages, and associations between accessible CRM objects

Optional data depends on the HubSpot plan and the permissions granted during connection. Reconnect HubSpot after an admin adds access so Contrast can request the new permissions.

Troubleshooting

SymptomWhat to do
The production account is not listedSign in to the correct HubSpot user. Use a Super Admin, or grant the user HubSpot Marketplace Access and the requested CRM permissions.
HubSpot shows an unverified-app warningConfirm the app is Contrast Warehouse Ingestion and the requested permissions match this guide, then select Connect app. Do not continue for a different app name or unexpected write access.
Contacts, companies, or deals are missingReconnect with a user who can grant read access to all three core object types.
An optional table is missingConfirm the HubSpot account has that product and the installing user can grant its read permission, then reconnect.
Authorization returns to Contrast but no tables appearRetry catalog discovery. If it still fails, reconnect HubSpot and confirm the core permissions were granted.
A working sync fails after HubSpot permissions changeReconnect HubSpot, run catalog discovery again, and retry the sync.

HubSpot documents the same installation permissions and OAuth behavior in Working with OAuth and Manage apps in HubSpot.

Security

Contrast stores encrypted OAuth access and refresh tokens, the HubSpot account ID, and the granted permission list. It does not store a HubSpot password or a customer-created private-app token. The connector reads CRM data and does not request write access to change HubSpot records.