> For the complete documentation index, see [llms.txt](https://help.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.botpenguin.com/settings/third-party-apps/hubspot-crm.md).

# HubSpot CRM

HubSpot CRM lets your AI agents and chatbots add contacts, update deals and write notes in your HubSpot account. You connect it once in Third party apps. HubSpot asks you to sign in and approve access, and the configuration is added.

***

### Prerequisites

* A BotPenguin account with access to the More menu.
* A HubSpot account that can approve access for apps.
* A pop-up blocker that allows the HubSpot sign-in window.

***

### Key Definitions

| Term               | Meaning                                                          |
| ------------------ | ---------------------------------------------------------------- |
| Third party apps   | The page in More where you connect other software to BotPenguin. |
| Connection         | One saved HubSpot account that your agents can use.              |
| Connected accounts | The tab that lists every account you connected for this app.     |

***

### Steps

1. Click **More** in the left menu, then click Third party apps.

![Click More, then Third party apps](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/VEeg8f3UkpfM0LWM3j1T/images/hubspot-crm-step-1.png)

2. Type HubSpot in the search box, then open the **HubSpot** card. Do not open HubSpot MCP, which is a different app.

![Search for HubSpot and open its card](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/iLonQlrqC3SkelPz9GFG/images/hubspot-crm-step-2.png)

3. On the Connected accounts tab, click **Add connection**. The HubSpot OAuth opens.

![Click Add connection on the HubSpot page](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/DAlkV9vrMlUoeNZgIeEi/images/hubspot-crm-step-3.png)

4. Check the Connected accounts tab. Your HubSpot account appears in the list with an Active status.

![The Connected accounts tab shows one Active account](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/D0HfN8meAgoFa061ahum/images/hubspot-crm-step-6.png)

***

### Common Errors

<details>

<summary>I do not see Third party apps in the More menu</summary>

Click More in the left menu and look under Connections for Third party apps. If it is still missing, your role may not allow it. Ask your account owner.

</details>

<details>

<summary>I see two HubSpot cards</summary>

HubSpot is the CRM app. HubSpot MCP is a separate app for MCP tools. Open the card named HubSpot to follow this guide.

</details>

<details>

<summary>Save Configuration is grey</summary>

You can save only after you sign in. Click Continue with HubSpot first, then wait for Connected as to show.

</details>

<details>

<summary>The HubSpot sign-in window did not open</summary>

Your browser may have blocked the pop-up. Allow pop-ups for BotPenguin, then click Continue with HubSpot again.

</details>

<details>

<summary>The sign-in window closed and HubSpot is not connected</summary>

You may have cancelled the approval, or waited too long, or HubSpot refused the request. Click Continue with HubSpot again and finish the approval.

</details>

<details>

<summary>Can I connect more than one HubSpot account?</summary>

Yes. Click Add connection again. Give each one a clear Connection name so you can pick the right one when you build an agent.

</details>

<details>

<summary>My agent says the connection needs to be reconnected</summary>

Access was removed in HubSpot, or HubSpot no longer accepts the saved sign-in, for example after a password reset. Add the connection again and sign in again.

</details>

***

### Support

Still not working? Write to us at <support@botpenguin.com>. We will reach out to you within 24 hours.
