> ## Documentation Index
> Fetch the complete documentation index at: https://help.get-ryze.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect HubSpot

> Connect your HubSpot account with OAuth so the agent can read and edit CRM contacts, companies, and deals, plus CMS blog content.

HubSpot connects with **OAuth** — you sign in to HubSpot and approve access, so Ryze never sees your password. Once connected, the agent can read and edit your CRM contacts, companies, and deals, read your contact lists and account owners, and manage CMS blog content.

## Step 1 — Connect in Ryze

In **Workspace Settings → Integrations**, find the HubSpot card and click **Connect**. You're redirected to HubSpot to authorize.

## Step 2 — Authorize in HubSpot

<Steps>
  <Step title="Sign in to HubSpot">
    Sign in to the HubSpot account you want to connect, or create a new one.

    <Frame>
      <img src="https://mintcdn.com/ryzeai-5f9aafd5/EqKnLZuyDdJXitAh/images/hubspot-oauth-account.png?fit=max&auto=format&n=EqKnLZuyDdJXitAh&q=85&s=477424e3e591705237cd65908b864583" alt="The HubSpot screen to sign in or create an account when connecting Ryze AI" width="3108" height="1770" data-path="images/hubspot-oauth-account.png" />
    </Frame>
  </Step>

  <Step title="Choose the account">
    If you have access to more than one HubSpot account (portal), pick the one you want Ryze to work with, then click **Choose Account**.

    <Frame>
      <img src="https://mintcdn.com/ryzeai-5f9aafd5/EqKnLZuyDdJXitAh/images/hubspot-choose-account.png?fit=max&auto=format&n=EqKnLZuyDdJXitAh&q=85&s=fa66a9b073bc03c2b37e27f76f76af08" alt="Choosing which HubSpot account to connect to Ryze AI" width="3108" height="1770" data-path="images/hubspot-choose-account.png" />
    </Frame>
  </Step>

  <Step title="Approve access">
    Review the requested permissions and approve. HubSpot sends you back to Ryze and the connection is saved.
  </Step>
</Steps>

## Step 3 — Confirm the connection

Back in Ryze, the HubSpot card shows a **Connected** badge and the account you linked — identified by its domain (like `pantio.io`).

<Frame>
  <img src="https://mintcdn.com/ryzeai-5f9aafd5/EqKnLZuyDdJXitAh/images/hubspot-connected.png?fit=max&auto=format&n=EqKnLZuyDdJXitAh&q=85&s=f3c6659f41f78a52999ad6c2257ed133" alt="The connected HubSpot account shown in Ryze with an option to add another account" width="3108" height="1770" data-path="images/hubspot-connected.png" />
</Frame>

## Connect multiple accounts

You can connect more than one HubSpot account (portal) in the same workspace. Click **Add one more account** on the HubSpot card and repeat the authorization. See [Connect multiple accounts](/integrations/multiple-accounts) for how the agent picks between them.

## What the agent can do

Once connected, the agent works with HubSpot through your account:

* **CRM records** — read and edit contacts, companies, and deals
* **Search** — filter and query records with the HubSpot CRM Search API
* **Lists** — read your contact lists
* **Owners** — look up account owners to attribute records
* **CMS** — read and edit blog content

<Tip>
  After connecting, start a **new chat** so the agent picks up the new integration.
</Tip>

## Troubleshooting

* **Wrong account connected** — each connection is one HubSpot portal. To switch, connect the right portal with **Add one more account**, or reconnect and choose a different account during authorization.
* **Connection stopped working** — click **Reconnect** on the HubSpot card and re-authorize. This refreshes access if permissions changed or the token was revoked in HubSpot.
* **Missing records or fields** — HubSpot returns a default set of properties; ask the agent for the specific fields you need. If a whole object type is missing, the connected user may not have access to it in HubSpot.

Still stuck? Email [support@get-ryze.ai](mailto:support@get-ryze.ai).