Skip to main content

HubSpot Connector

Connect to HubSpot to index contacts, companies, deals, tickets, and marketing content.

Overview

The HubSpot connector allows you to:

  • Index CRM records
  • Access marketing content
  • Sync engagement history
  • Search across all hubs

Prerequisites

  • HubSpot account
  • API access (any tier)
  • OAuth authorization

Authentication

OAuth 2.0

  1. Click Connect with HubSpot
  2. Authorize ZenSearch
  3. Select account if multiple

Configuration

SettingDescription
ObjectsRecord types to sync
PropertiesFields to index
Date RangeRecord modification period

Setup Steps

  1. Add Connector: Knowledge → Add Data Source → HubSpot
  2. Authorize: OAuth with HubSpot
  3. Select Objects: Choose CRM objects
  4. Configure Properties: Select fields
  5. Test & Create: Verify and save

Objects Indexed

ObjectContent
ContactsPeople records
CompaniesOrganization data
DealsSales pipeline
TicketsSupport requests
NotesActivity notes
EmailsEmail history

Best Practices

  1. Focus on active records
  2. Include engagement history for context
  3. Sync notes for meeting summaries
  4. Filter by date for relevance

Troubleshooting

Authorization failed: Re-authenticate OAuth flow

Missing data: Check account permissions

Rate limits: HubSpot enforces API limits by tier