From f5f6b251d11531c4accb2c370b30937013c8d5d4 Mon Sep 17 00:00:00 2001 From: sergeikofman444 Date: Fri, 12 Jun 2026 09:56:13 -0400 Subject: [PATCH 1/2] remove manual configuration description --- integrations/integration-guides/hubspot.mdx | 115 ++------------------ 1 file changed, 11 insertions(+), 104 deletions(-) diff --git a/integrations/integration-guides/hubspot.mdx b/integrations/integration-guides/hubspot.mdx index 1dfcb53a..f189b505 100644 --- a/integrations/integration-guides/hubspot.mdx +++ b/integrations/integration-guides/hubspot.mdx @@ -20,110 +20,17 @@ The official HubSpot integration allows your bot to interact with your HubSpot a ## Setup - - - - You will need: - - - A [published bot](/get-started/quick-start) - - A [HubSpot account](https://hubspot.com) - - - 1. In Botpress Studio, select **Explore Hub** in the upper-right corner. - 2. Search for the **HubSpot** integration, then select **Install Integration**. - 3. In the **Configuration** menu, select **Authorize HubSpot**. - 4. Follow the instructions to connect Botpress to your HubSpot account. - - - For advanced use cases, you can use your own HubSpot app with our integration. - - - You will need: - - - A [published bot](/get-started/quick-start) - - A [HubSpot account](https://hubspot.com) - - - ### Step 1: Install the HubSpot integration in Botpress - - - In Botpress Studio, select **Explore Hub** in the upper-right corner. - Search for the **HubSpot** integration, then select **Install Integration**. - In the **Configuration** menu, select the drop-down menu, then select **Manual configuration, use your own HubSpot app**. - Copy the webhook URL—you'll need it when configuring your HubSpot app. - Leave the configuration fields empty for now—you'll come back to them after you've setup your HubSpot app. - - - ### Step 2: Create a HubSpot app - - Next, you'll need to create a HubSpot app for your bot: - - - Open a new tab and [log into your HubSpot account](https://app.hubspot.com/login). - In the upper-right corner, select your organization name, then select **Profile & Preferences**. - Under **Account Management**, select **Integrations**, then **Legacy Apps**. - Select **Create legacy app** in the upper-right corner. Then, select **Private**. - - - ### Step 3: Add scopes to your HubSpot app - - Now, add the required scopes for the HubSpot app to work: - - - In the **Scopes** section, select **+ Add new scope**. - - Add the following scopes: - - `oauth` - - `tickets` - - `crm.objects.contacts.read` - - `crm.objects.contacts.write` - - `crm.objects.owners.read` - - `crm.objects.companies.read` - - `crm.objects.companies.write` - - `crm.objects.leads.read` - - `crm.objects.leads.write` - - `crm.objects.deals.read` - - `crm.objects.deals.write` - - When you're done, select **Update**. - - - ### Step 4: Subscribe to Webhook events (optional) - - Optionally, you can subscribe to Webhook events—these are necessary if you want to use the integration's [Triggers](/studio/concepts/triggers): - - - Navigate to the **Webhooks** tab, then paste the webhook URL you copied earlier into the **Target URL** field. - Set **Event throttling** to `1`, then select **Create subscription**. - Enable **Use expanded object support**. - - From the **Which object types** drop-down, select: - - Company - - Contact - - Ticket - - Lead - - - From the **Listen for which events** drop-down, select: - - Created - - Deleted - - Select **Subscribe**. - Select **Create app** in the upper-right corner. Then, select **Continue creating**. - - - ### Step 5: Configure the integration in Botpress - - Now you can use your app's credentials to fill in the configuration fields from [Step 1](#install-the-hubspot-integration-in-botpress): - - - From your HubSpot app's menu, navigate to the **Auth** tab. - Copy the **Access token** and **Client secret**. - Paste them into the integration's **Access Token** and **Client Secret** fields. - Scroll down and select **Save Configuration**. This automatically activates the integration. - - - + + You will need: + + - A [published bot](/get-started/quick-start) + - A [HubSpot account](https://hubspot.com) + + +1. In Botpress Studio, select **Explore Hub** in the upper-right corner. +2. Search for the **HubSpot** integration, then select **Install Integration**. +3. In the **Configuration** menu, select **Authorize HubSpot**. +4. Follow the instructions to connect Botpress to your HubSpot account. Your HubSpot integration is ready—you can use the integration's [Cards](/studio/concepts/cards/introduction) and [Triggers](/studio/concepts/triggers) to interact with your HubSpot account. From bb4a1af2cb71a233b358a3e9b28771ff2794ebed Mon Sep 17 00:00:00 2001 From: sergeikofman444 Date: Fri, 12 Jun 2026 10:44:00 -0400 Subject: [PATCH 2/2] updated hubspot version --- .../integrations/cards/botpress/hubspot.mdx | 224 ++++++++++++++++++ snippets/integrations/versions.mdx | 4 +- 2 files changed, 226 insertions(+), 2 deletions(-) diff --git a/snippets/integrations/cards/botpress/hubspot.mdx b/snippets/integrations/cards/botpress/hubspot.mdx index 666884c4..5f4786e8 100644 --- a/snippets/integrations/cards/botpress/hubspot.mdx +++ b/snippets/integrations/cards/botpress/hubspot.mdx @@ -744,6 +744,13 @@ Here's a reference for all [Cards](/studio/concepts/cards/introduction) availabl {"The properties of the contact"} + + + {"The URL to the contact's page in the HubSpot UI"} @@ -820,6 +827,39 @@ Here's a reference for all [Cards](/studio/concepts/cards/introduction) availabl +### Get File URL + +{"Get a URL to access a file stored in Hubspot Files"} + + + + + {"The path to the Hubspot file"} + + + + + + + + {"The URL of the file, or undefined if not available"} + + + + ### Get Lead {"Get a lead from HubSpot"} @@ -892,6 +932,178 @@ Here's a reference for all [Cards](/studio/concepts/cards/introduction) availabl +### Get Owner + +{"Get a Hubspot owner (user) by ID. Used to resolve owner references on contacts, deals, etc."} + + + + + {"The ID of the owner to fetch"} + + + + + + + + {"The owner found, or undefined if not found"} + + + + {"The ID of the owner"} + + + {"The email of the owner"} + + + {"The first name of the owner"} + + + {"The last name of the owner"} + + + {"The Hubspot user ID associated with the owner"} + + + {"The type of owner (e.g. PERSON, QUEUE)"} + + + {"Whether the owner is archived"} + + + {"The date and time the owner was created"} + + + {"The date and time the owner was last updated"} + + + + + + +### List Contact Properties + +{"List all available Hubspot contact properties with their metadata"} + + + This Card has no input fields. + + + + + + {"The contact properties defined in this Hubspot account"} + + + + {"The internal name of the property"} + + + {"The human-readable label of the property"} + + + {"The data type of the property (e.g. string, number, date, datetime, enumeration, bool)"} + + + {"The form field type of the property (e.g. text, textarea, select, radio, checkbox)"} + + + {"The internal name of the property group"} + + + {"The description of the property"} + + + {"The type of object referenced by this property (e.g. OWNER), if any"} + + + + + + ### List Contacts {"List contacts in HubSpot"} @@ -1099,6 +1311,12 @@ Here's a reference for all [Cards](/studio/concepts/cards/introduction) availabl type="string" > {"The phone number of the contact to search for"} + + + {"The list of property names to fetch on the matching contact. Defaults to all properties."} @@ -1158,6 +1376,12 @@ Here's a reference for all [Cards](/studio/concepts/cards/introduction) availabl {"The properties of the contact"} + + + {"The URL to the contact's page in the HubSpot UI, or undefined if no contact was found"} diff --git a/snippets/integrations/versions.mdx b/snippets/integrations/versions.mdx index 2f724c78..4299243b 100644 --- a/snippets/integrations/versions.mdx +++ b/snippets/integrations/versions.mdx @@ -304,8 +304,8 @@ export const integrationVersions = { "id": "intver_01JFAQXRQ8TADY78EBPBKSXFPC" }, "hubspot": { - "version": "6.0.5", - "id": "intver_01KRPJKZ1ER9XBZQC5QTXBRGND" + "version": "6.0.9", + "id": "intver_01KTV8S0ZX48N54R7AVG24CHJZ" }, "hunter": { "version": "1.0.2",