--- title: HubSpot App Guide description: How to add, use, troubleshoot, and remove the HubSpot app in OOMOL. lang: en canonical_url: https://oomol.com/en/docs/hubspot/ markdown_url: https://oomol.com/en/docs/hubspot.md --- # HubSpot app guide > Last updated on June 10, 2026 OOMOL lets you connect HubSpot once, then make authorized HubSpot CRM tools available to the AI agents and reusable Skills you already work with. This guide explains how to add the HubSpot app, what permissions OOMOL uses, what you can do with it, how to troubleshoot common issues, and how to remove the app. ## Prerequisites - An OOMOL account. - A HubSpot account that you are allowed to authorize for third-party apps. - Access to the OOMOL Console at [https://console.oomol.com/](https://console.oomol.com/). - Permission in HubSpot to authorize apps with CRM object and CRM schema scopes. - Test contact, company, and deal records if you want to try search, read, or update tools. - If your HubSpot organization restricts third-party apps, your HubSpot administrator may need to allow the OOMOL app before you can authorize it. ## Adding the app 1. Sign in to the [OOMOL Console](https://console.oomol.com/). 2. Open **Connectables** or go directly to [Connections](https://console.oomol.com/connections). 3. Search for **HubSpot**. 4. Select **HubSpot**, then choose **Connect**. 5. OOMOL redirects you to HubSpot. Sign in to HubSpot if prompted. 6. Review the HubSpot authorization screen, including the requested CRM permissions. 7. Select the HubSpot account you want to connect. 8. Select **Connect app** or the equivalent authorization action shown by HubSpot. 9. After HubSpot redirects you back to OOMOL, confirm that HubSpot appears as connected in your OOMOL connections. If any step fails, see [Troubleshooting](#troubleshooting). After authorization, OOMOL stores the connection needed to call HubSpot tools on your behalf. You can then use HubSpot tools from OOMOL-supported agents, reusable Skills, and workflows. ## Usage HubSpot tools are available only after you connect a HubSpot account. The exact tool list shown in OOMOL may change as the connector is updated, but the current HubSpot connector supports reading CRM property definitions and searching, reading, creating, and updating contacts, companies, and deals. ### Use HubSpot tools with oo-cli To make connected HubSpot tools available in a supported AI agent environment, install and configure `oo-cli` after you sign in to OOMOL. 1. Sign in to the [OOMOL Console](https://console.oomol.com/). 2. Open the [oo-cli installation page](https://console.oomol.com/install-oo-cli). 3. Follow the instructions on that page. The page provides a one-click copy prompt for installing and configuring `oo-cli` in a supported AI agent environment. 4. After `oo-cli` is configured and HubSpot is connected in OOMOL, ask the agent to use the connected HubSpot CRM tools with demo CRM data. The exact agent prompt can vary by environment. For example, you can ask the agent to create a demo contact, search for that contact by email, update an editable field such as job title, or list HubSpot CRM properties. ### Permissions used OOMOL uses these HubSpot scopes to let an authorized HubSpot user connect HubSpot as an App in OOMOL, then make approved CRM tools available to agents and reusable Skills. Required scopes: | HubSpot scope | Used by | Why OOMOL uses it | | --- | --- | --- | | `oauth` | HubSpot OAuth connection | Complete the HubSpot OAuth authorization flow and maintain the authorized HubSpot connection in OOMOL. | | `crm.objects.contacts.read` | Search Contacts, Get Contact | Search and read HubSpot contact records when a user or approved agent action asks for contact information. | | `crm.objects.contacts.write` | Create Contact, Update Contact | Create or update HubSpot contact records when a user or approved agent action provides the required contact details. | | `crm.objects.companies.read` | Search Companies, Get Company | Search and read HubSpot company records when a user or approved agent action asks for company information. | | `crm.objects.companies.write` | Create Company, Update Company | Create or update HubSpot company records when a user or approved agent action provides the required company details. | | `crm.objects.deals.read` | Search Deals, Get Deal | Search and read HubSpot deal records when a user or approved agent action asks for deal information. | | `crm.objects.deals.write` | Create Deal, Update Deal | Create or update HubSpot deal records when a user or approved agent action provides the required deal details. | | `crm.schemas.contacts.read` | List Properties, Get Property | Read contact property definitions so tools can use valid HubSpot contact fields. | | `crm.schemas.companies.read` | List Properties, Get Property | Read company property definitions so tools can use valid HubSpot company fields. | | `crm.schemas.deals.read` | List Properties, Get Property | Read deal property definitions so tools can use valid HubSpot deal fields. | ### Supported HubSpot tools | Tool | Supported function | Typical use case | Prerequisites | | --- | --- | --- | --- | | List Properties | List property definitions for contacts, companies, or deals. | Let an agent understand which CRM fields are available before creating filters, creating records, or updating fields. | HubSpot is connected in OOMOL and the connected account has access to CRM property schemas. | | Get Property | Read one property definition, such as the `email` property on contacts. | Check a specific CRM field before using it in a search, create, or update action. | HubSpot is connected in OOMOL and the requested property exists. | | Search Contacts | Search contacts with keywords, filters, sorting, and selected return fields. | Find the right person before a call, handoff, support task, or follow-up. | HubSpot is connected in OOMOL and the connected account can read contacts. | | Get Contact | Read one contact by HubSpot record ID or a custom unique property. | Pull contact details into an agent workflow before taking the next step. | HubSpot is connected in OOMOL and the requested contact is available to the connected account. | | Create Contact | Create a contact with provided properties and optional associations. | Save a new lead, customer, or stakeholder from information the user gives to the agent. | HubSpot is connected in OOMOL and the user has the required contact details. | | Update Contact | Update contact properties by record ID or a custom unique property. | Keep a contact record current after a call, email, research task, or workflow step. | HubSpot is connected in OOMOL, the contact can be located, and the user has approved the updated details. | | Search Companies | Search companies with keywords, filters, sorting, and selected return fields. | Find account information before preparing research, outreach, or follow-up. | HubSpot is connected in OOMOL and the connected account can read companies. | | Get Company | Read one company by HubSpot record ID or a custom unique property. | Pull account details into an agent workflow before creating notes, plans, or updates. | HubSpot is connected in OOMOL and the requested company is available to the connected account. | | Create Company | Create a company with provided properties and optional associations. | Add a new account from user-provided company information. | HubSpot is connected in OOMOL and the user has the required company details. | | Update Company | Update company properties by record ID or a custom unique property. | Keep account details current after research, sales work, or operations review. | HubSpot is connected in OOMOL, the company can be located, and the user has approved the updated details. | | Search Deals | Search deals with keywords, filters, sorting, and selected return fields. | Find the right opportunity before pipeline review, forecasting, or follow-up. | HubSpot is connected in OOMOL and the connected account can read deals. | | Get Deal | Read one deal by HubSpot record ID or a custom unique property. | Pull opportunity details into an agent workflow before summarizing or updating it. | HubSpot is connected in OOMOL and the requested deal is available to the connected account. | | Create Deal | Create a deal with provided properties and optional associations. | Add a new opportunity from user-provided sales information. | HubSpot is connected in OOMOL and the user has the required deal details. | | Update Deal | Update deal properties by record ID or a custom unique property. | Keep pipeline details current after a customer interaction or internal review. | HubSpot is connected in OOMOL, the deal can be located, and the user has approved the updated details. | ### Search and read CRM records Use case: let an agent find the right HubSpot contact, company, or deal before a call, handoff, research task, or follow-up. Prerequisites: - HubSpot is connected in OOMOL. - The connected HubSpot account has permission to read the requested CRM object. - The agent or workflow has a search keyword, filter, record ID, or unique property value. What the tools do: - Search or read contacts, companies, and deals available to the connected HubSpot account. - Return the HubSpot fields requested by the tool input when they are available. - Do not create, update, or delete records during read-only actions. ### Create CRM records Use case: let an agent create a HubSpot contact, company, or deal from user-provided information, such as a new customer, account, or opportunity. Prerequisites: - HubSpot is connected in OOMOL. - The connected HubSpot account has permission to create the requested CRM object. - The agent or workflow has the required properties for the new record. - If associations are included, the related records must be valid and available to the connected account. What the tools do: - Create a HubSpot contact, company, or deal based on the provided inputs. - Return the record information made available by HubSpot, such as the record ID and selected properties. - Do not invent missing CRM values. Required values must be provided by the user, workflow, or connected data source. ### Update CRM records Use case: let an agent keep HubSpot records up to date when a user asks it to change a contact, company, or deal field. Prerequisites: - HubSpot is connected in OOMOL. - The connected HubSpot account has permission to update the requested CRM object. - The agent or workflow can locate the target record by HubSpot record ID or a custom unique property. - The updated values are valid for the HubSpot property definitions. What the tools do: - Update supported HubSpot contact, company, or deal properties based on the provided inputs. - Return the update result made available by HubSpot. - Do not delete records. ## Testing the app You can test the HubSpot app with any HubSpot account that you are allowed to authorize. Use demo contacts, companies, and deals so you can safely test search, create, and update actions. ### Sample test prompts - Create a HubSpot contact named `Demo Contact` with email `demo-contact@example.com`. - Search HubSpot contacts for `demo-contact@example.com`. - Get the HubSpot contact with email `demo-contact@example.com`. - Update the HubSpot contact with email `demo-contact@example.com` and set the job title to `Demo Buyer`. - Search HubSpot companies for `Demo Company`. - Create a HubSpot company named `Demo Company`. - Search HubSpot deals for `Demo Deal`. - Create a HubSpot deal named `Demo Deal` with sample test values. - Update the `Demo Deal` amount or close date. - List HubSpot contact properties. - Get the HubSpot contact property definition for `email`. Use only demo data during testing. Do not use real customer data in test prompts. ## Troubleshooting ### I cannot add the HubSpot app - Make sure you are signed in to the correct OOMOL account. - Make sure you are signing in to the HubSpot account you want to connect. - Confirm that the HubSpot account allows the requested CRM scopes. - If the HubSpot account belongs to an organization, ask a HubSpot administrator whether third-party apps require approval. - Try disconnecting any failed or partial HubSpot connection in OOMOL, then connect again. - If the issue continues, contact OOMOL support and include the OOMOL account email, the HubSpot account or portal ID, the time of the attempt, and any error message or screenshot. ### A HubSpot tool cannot find a record - Confirm that the connected HubSpot account has access to the requested contact, company, or deal. - Confirm that the workflow is using the correct record ID, unique property, search keyword, or filter. - Check whether the record exists in the HubSpot account connected to OOMOL. - If you recently changed HubSpot permissions, reconnect HubSpot in OOMOL so the authorization state is refreshed. ### A HubSpot tool cannot create a record - Confirm that the connected HubSpot account can create the requested contact, company, or deal directly in HubSpot. - Check that all required HubSpot properties are included. - Check that the provided values are valid for the HubSpot property definitions. - If associations are included, confirm that the associated records and association types are valid. ### A HubSpot tool cannot update a record - Confirm that the connected HubSpot account has permission to update the requested record. - Confirm that the workflow is using the correct HubSpot record ID or custom unique property. - Check that the updated fields and values are valid for HubSpot. - If a property is read-only or restricted in HubSpot, remove it from the update request or update it directly in HubSpot. ## Removing the app You can remove the HubSpot app from either OOMOL or HubSpot. We recommend removing it from both places if you no longer want OOMOL to access HubSpot. ### Remove HubSpot from OOMOL 1. Sign in to the [OOMOL Console](https://console.oomol.com/). 2. Open [Connections](https://console.oomol.com/connections). 3. Find **HubSpot** in your connected apps. 4. Open the HubSpot connection details. 5. Choose **Disconnect**, **Remove**, or the equivalent removal action shown in OOMOL. 6. Confirm the removal. ### Remove OOMOL from HubSpot 1. Sign in to HubSpot. 2. Open **Settings**. 3. Open **Integrations** and then **Connected Apps**. 4. Find **OOMOL**. 5. Choose the action to uninstall, disconnect, or remove the app. 6. Confirm the removal. ## What happens after removal - OOMOL can no longer use HubSpot tools for your account after the HubSpot connection is removed or de-authorized. - Workflows, agents, or Skills that depend on HubSpot may fail until you reconnect HubSpot. - Existing HubSpot records created or updated before removal remain in HubSpot unless you change or delete them in HubSpot. - Removing the app does not delete your OOMOL account. ## Data handling OOMOL accesses HubSpot data only after a HubSpot user authorizes the app and a user or approved agent action requires HubSpot. OOMOL uses HubSpot data only to provide the HubSpot tools requested through OOMOL-supported agents, reusable Skills, and workflows. - HubSpot OAuth tokens are stored encrypted. - HubSpot OAuth tokens are not exposed to AI agents, prompts, project files, or end users. - OOMOL may process HubSpot contact, company, deal, and CRM property metadata when a HubSpot tool is called. - HubSpot data may be stored only as needed in user-visible tool results, usage records, execution history, or operational records. - Stored data is encrypted at rest and transmitted over TLS/SSL. - OOMOL does not sell your HubSpot data. - OOMOL does not use HubSpot data for advertising. - OOMOL does not use private customer content to train AI models. - When you remove or de-authorize the HubSpot app, OOMOL stops using the revoked HubSpot authorization. OOMOL deletes or invalidates the stored HubSpot authorization tokens according to its normal connection removal process. - Some logs, support records, security records, or billing-related records may be retained as described in the [Privacy Policy](/en/privacy/). ## FAQ ### Does OOMOL continuously sync HubSpot data? No. OOMOL does not continuously sync or replicate HubSpot data in the background. HubSpot data is accessed when an authorized user or approved agent action calls a HubSpot tool. ### Can an agent use HubSpot automatically after I connect it? Connecting HubSpot makes HubSpot tools available in OOMOL, but tool use still depends on the agent, workflow, Skill, and permissions you choose. Account-based services still require your authorization. ### Can OOMOL delete HubSpot records? The current HubSpot connector described in this guide supports searching, reading, creating, and updating contacts, companies, and deals. It does not include a delete record tool. ### Can I connect more than one HubSpot account? Use the OOMOL Console to check the current connection options available to your account or workspace. If you need help with multiple HubSpot accounts, contact support. ### Do I need a paid HubSpot account? Most OOMOL HubSpot tools require a HubSpot account that can authorize the requested CRM scopes. Some HubSpot features, object access, property access, or admin controls may depend on your HubSpot plan or organization settings. ## Contact support If you need help adding, using, testing, or removing the HubSpot app, contact OOMOL support: - Email: [support@oomol.com](mailto:support@oomol.com) - Support page: [https://oomol.com/en/support/](https://oomol.com/en/support/) Please include your OOMOL account email, the connected HubSpot account or portal ID if relevant, the action you were trying to perform, and any error message or screenshot.