> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cassidyai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot Agent Connector

> Let Agents query and update HubSpot records in real time during conversations.

The HubSpot [Connector](/agents/connectors/overview) lets your [Agents](/agents/overview) search and retrieve customer information from HubSpot CRM during conversations. When a user asks about a contact, deal, or company, the Agent queries HubSpot in real time and returns the relevant data. The Connector is designed for searching and retrieving specific information rather than analyzing large datasets.

<Info>For best results with Connector queries, use a powerful, reasoning-capable model. Cassidy supports models from OpenAI, Anthropic, and Google — see [Choose the right AI model](/guides/choose-ai-model) for current recommendations.</Info>

<Tip>The HubSpot Connector works best for searching specific information or small batch queries. For complex data analysis queries like "what is our average deal size this year," consider using [Code Execution & File Creation](/agents/advanced/code-execution-file-creation) or exporting data from HubSpot directly.</Tip>

## Set up the HubSpot Connector

<Steps>
  <Step title="Select your Agent">
    Navigate to **Agents**, find the Agent you want to configure, click **...** and select **Edit**.

    <Frame>
      <img src="https://mintcdn.com/cassidy/38rZ74SkXvjjDNWl/images/integrations/hubspot-select-agent.png?fit=max&auto=format&n=38rZ74SkXvjjDNWl&q=85&s=5d36049ff88484f96740e9240b97d6a7" alt="Agent card context menu showing Open in new chat, Duplicate, Edit, and Delete options" width="650" height="484" data-path="images/integrations/hubspot-select-agent.png" />
    </Frame>
  </Step>

  <Step title="Navigate to Connectors">
    In the **Setup** tab, scroll to the **Connectors** section.

    <Frame>
      <img src="https://mintcdn.com/cassidy/38rZ74SkXvjjDNWl/images/integrations/hubspot-connectors-section.png?fit=max&auto=format&n=38rZ74SkXvjjDNWl&q=85&s=e6432723b169658bd6f23d9a5ffa03be" alt="Agent editor Setup tab showing the Connectors section with existing connectors and Add Connector button" width="1024" height="282" data-path="images/integrations/hubspot-connectors-section.png" />
    </Frame>
  </Step>

  <Step title="Add HubSpot">
    Click **+ Add Connector** and click **+ Add** on the **HubSpot** option.

    <Frame>
      <img src="https://mintcdn.com/cassidy/38rZ74SkXvjjDNWl/images/integrations/hubspot-connectors-dialog.png?fit=max&auto=format&n=38rZ74SkXvjjDNWl&q=85&s=717da609fa217bf6f293164f0d284462" alt="Connectors dialog showing available connectors including Airtable, BigQuery, HubSpot, and Salesforce with Add buttons" width="1024" height="632" data-path="images/integrations/hubspot-connectors-dialog.png" />
    </Frame>
  </Step>

  <Step title="Choose a connection method">
    Select how users will authenticate with HubSpot:

    * **Each user connects their own account** (recommended) — Users sign in with their HubSpot credentials on first use. Respects each user's individual permissions. Best for teams with varying access levels.
    * **Use a shared HubSpot connection** — All users access HubSpot through one account using your organization's existing connections.

    <Frame>
      <img src="https://mintcdn.com/cassidy/38rZ74SkXvjjDNWl/images/integrations/hubspot-connection-method.png?fit=max&auto=format&n=38rZ74SkXvjjDNWl&q=85&s=2899ab011ef19a50ef37ad959a251951" alt="HubSpot Connection Setup dialog showing per-user (recommended) and shared connection options with Add Tool button" width="1024" height="614" data-path="images/integrations/hubspot-connection-method.png" />
    </Frame>
  </Step>

  <Step title="Set up a shared connection (if selected)">
    If you chose **Use a shared HubSpot connection**, click **Connect** to sign in. You'll be redirected to HubSpot to select your account and accept the access request.

    <Frame>
      <img src="https://mintcdn.com/cassidy/38rZ74SkXvjjDNWl/images/integrations/hubspot-shared-no-connection.png?fit=max&auto=format&n=38rZ74SkXvjjDNWl&q=85&s=4e085b61658a16d6f5e2778f9f507645" alt="Select HubSpot Connection screen showing No connection selected with Connect button" width="1024" height="183" data-path="images/integrations/hubspot-shared-no-connection.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/38rZ74SkXvjjDNWl/images/integrations/hubspot-oauth.png?fit=max&auto=format&n=38rZ74SkXvjjDNWl&q=85&s=beab0c1dd6db24d9114d0585db65e65e" alt="HubSpot OAuth authorization screen showing Connecting Cassidy Assistant to HubSpot with account selection" width="869" height="1024" data-path="images/integrations/hubspot-oauth.png" />
    </Frame>
  </Step>

  <Step title="Save the Connector">
    Once connected, click **Save** to complete the setup.

    <Frame>
      <img src="https://mintcdn.com/cassidy/38rZ74SkXvjjDNWl/images/integrations/hubspot-shared-connected.png?fit=max&auto=format&n=38rZ74SkXvjjDNWl&q=85&s=7ed12ef9e921532322c19ea914d07cf7" alt="Shared HubSpot connection configured showing connected account with limited access notice and Save button" width="1024" height="780" data-path="images/integrations/hubspot-shared-connected.png" />
    </Frame>
  </Step>

  <Step title="Start a chat">
    Navigate to **Chat** and select the Agent with the HubSpot Connector enabled.

    If you chose **Each user connects their own account**, users are prompted to connect their HubSpot account from within the chat the first time they use the Connector. Click **Connect** when prompted.

    <Frame>
      <img src="https://mintcdn.com/cassidy/38rZ74SkXvjjDNWl/images/integrations/hubspot-chat-connect-prompt.png?fit=max&auto=format&n=38rZ74SkXvjjDNWl&q=85&s=881e043933310b8414eeabbfa0e644d9" alt="Chat showing Connect HubSpot prompt with Connect and Skip for now buttons while the Agent is analyzing" width="1024" height="370" data-path="images/integrations/hubspot-chat-connect-prompt.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/38rZ74SkXvjjDNWl/images/integrations/hubspot-chat-no-connection.png?fit=max&auto=format&n=38rZ74SkXvjjDNWl&q=85&s=e50cdd64ea5fb865439d0f04984ec0cc" alt="Connect HubSpot dialog showing No connection selected with Connect button" width="1024" height="356" data-path="images/integrations/hubspot-chat-no-connection.png" />
    </Frame>

    Once connected, click **Save** to finalize the setup.

    <Frame>
      <img src="https://mintcdn.com/cassidy/38rZ74SkXvjjDNWl/images/integrations/hubspot-chat-connected.png?fit=max&auto=format&n=38rZ74SkXvjjDNWl&q=85&s=f665c5ac5fc844280dc945e5eda1d9db" alt="Connect HubSpot dialog showing connected account with Change and Save buttons" width="1024" height="386" data-path="images/integrations/hubspot-chat-connected.png" />
    </Frame>
  </Step>

  <Step title="Query HubSpot data">
    Your Agent can now access HubSpot data to answer questions about contacts, deals, companies, and other CRM records directly in the conversation.

    <Frame>
      <img src="https://mintcdn.com/cassidy/38rZ74SkXvjjDNWl/images/integrations/hubspot-query-result.png?fit=max&auto=format&n=38rZ74SkXvjjDNWl&q=85&s=cff69b92a9f1a27874cc43ab002e279f" alt="Agent response showing a deals snapshot table for Lawfirm LLP with key takeaways" width="1024" height="494" data-path="images/integrations/hubspot-query-result.png" />
    </Frame>
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Use HubSpot in Workflows" icon="diagram-project" href="/integrations/hubspot/workflows">
    Trigger Workflows from record changes and push AI-generated results back to your CRM.
  </Card>

  <Card title="Explore all Connectors" icon="plug" href="/agents/connectors/overview">
    Learn about other Connectors available for your Agents.
  </Card>
</CardGroup>
