Skip to main content

Minotaur × HubSpot — Integration Guide

App: Minotaur HubSpot Integration
Published by: Minotaur Sales
Supported on: app.minotaursales.io

Overview​

The Minotaur HubSpot integration lets you enrich existing HubSpot records with data from your Minotaur CRM:

  • Push contact data from Minotaur into matching HubSpot contacts.
  • Push company data from Minotaur into matching HubSpot companies.
  • Sync selected records or an entire contact list on demand.
  • Monitor sync progress via in-app notifications and a dedicated integration log.

Important behavior: This integration is update-only and one-way (Minotaur → HubSpot). It only updates records that already exist in HubSpot. If a Minotaur contact or company does not match an existing HubSpot record, that record is skipped — nothing is created. No data is pulled from HubSpot into Minotaur.

Scope of this integration: Contacts and Companies only. Deal sync is not supported.

Prerequisites​

RequirementDetails
HubSpot accountA HubSpot account (Sales Hub or any plan that includes the CRM).
HubSpot permissionsYou must have permission to install apps and to read/edit contacts and companies in HubSpot.
Existing HubSpot recordsRecords must already exist in HubSpot to be updated. Minotaur does not create new HubSpot contacts or companies.
Minotaur accountYou must be logged in to app.minotaursales.io and have access to Settings.

Adding the Integration (Install & Connect)​

  1. Log in to app.minotaursales.io.
  2. Navigate to Settings → Connections → HubSpot.
  3. Click Connect.
  4. A new browser tab opens with HubSpot's authorization page. Log in to your HubSpot account and review the requested permissions:
    • Read and write contacts and companies
    • Read and write deals and owners (for future compatibility — deals are not currently synced)
  5. Click Connect app.
  6. The tab closes and you are redirected back to Minotaur. The connection page now shows Connected with your HubSpot portal name and portal ID.

Configuring Field Mapping (Required Before Sync)​

Before you can sync any data, you must configure which Minotaur fields map to which HubSpot fields. Sync will fail with a "mapping not found" error if this step is skipped.

  1. Go to Settings → Connections → HubSpot → Field Mapping.
  2. Configure Contact field mapping: select which Minotaur contact fields correspond to HubSpot contact properties.
  3. Configure Company field mapping: select which Minotaur company fields correspond to HubSpot company properties.
  4. Review and save your mappings.

Email and phone fields are excluded from sync (used only for matching, not written to HubSpot). Only enrichment fields such as job title, industry, location, and social URLs can be mapped.

Using the Integration​

Syncing Selected Contacts​

  1. Go to My Contacts (or any contacts table).
  2. Select one or more contact rows using the checkboxes.
  3. Click Sync to HubSpot in the table toolbar.
  4. Confirm the action. Minotaur enqueues the selected contacts for sync.
  5. You receive an in-app notification when the sync completes. View detailed results in Settings → Integration Logs → HubSpot.

Syncing Selected Companies​

  1. Go to the Companies table.
  2. Select one or more company rows.
  3. Click Sync to HubSpot and confirm.

Company sync by list is not supported. Use the selection method above for companies.

Syncing an Entire Contact List​

  1. Go to Lists and open a contact list.
  2. Click Sync to HubSpot (available in the list's data table toolbar).
  3. Confirm the action. All contacts in the list are enqueued for sync.

Monitoring Sync Progress​

  • In-app notifications appear when sync jobs start and complete.
  • Integration Logs: go to Settings → Integration Logs → HubSpot for a detailed log of each sync operation.
  • Per-row sync date: in the Contacts and Lists tables, a HubSpot icon shows when each record was last synced to HubSpot.

How Matching Works​

Minotaur matches a Minotaur contact to a HubSpot contact using:

  1. The field(s) you designated as key fields in your field mapping.
  2. The contact's work email or personal email (always used as a lookup, regardless of mapping).

If no matching HubSpot contact is found, the record is skipped (not created). The same logic applies to companies.

Pausing Sync​

  1. Go to Settings → Connections → HubSpot.
  2. Click Pause sync on the status card.

While paused, the "Sync to HubSpot" buttons are hidden. Toggle again to Resume sync.

Removing the Integration​

  1. Go to Settings → Connections → HubSpot.
  2. Click Disconnect and confirm.
  3. Minotaur removes your stored OAuth tokens and revokes the HubSpot refresh token. The integration is fully disconnected.

Troubleshooting / FAQ​

"Mapping not found" error when syncing​

Field mappings have not been configured. Go to Settings → Connections → HubSpot → Field Mapping and complete the contact and/or company mapping before syncing.

Records were enqueued but nothing updated in HubSpot​

Minotaur could not find a matching contact or company in HubSpot. This integration is update-only — if the record doesn't already exist in HubSpot with the same email or key field value, it will be skipped.

Deals are not syncing​

Deal sync is not supported in the current version. Only Contacts and Companies can be synced.

The connection shows "Expired"​

Go to Settings → Connections → HubSpot, click Disconnect, then click Connect again to re-authorize.

Sync is slow or progress notifications are delayed​

Sync runs asynchronously in a background queue. Large batches may take a few minutes. Monitor progress at Settings → Integration Logs → HubSpot.

Data & Privacy​

Data typeHow it is used
HubSpot OAuth tokensStored securely in Minotaur's database, scoped to your user. Used only to push updates to HubSpot on your behalf.
HubSpot portal info (portal ID, domain)Displayed on the connection status card. Not shared externally.
Minotaur contact/company enrichment fieldsPushed one-way to HubSpot to update matching records. Only whitelisted fields are synced. Email and phone values are never written to HubSpot.
HubSpot record IDsCached in Minotaur for faster future sync lookups.

On disconnect: OAuth tokens are deleted and the HubSpot refresh token is revoked.

Support​

For help with this integration, contact Minotaur support:

For HubSpot-specific issues: