strapi-plugin-hubspot 0.14.0 → 0.15.0

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Unreleased
 
+## 0.15.0 — 2026-09-21
+
+### Added — account settings in the admin
+- **Settings → HubSpot** now holds the portal id, region (`eu1` / `na1`) and
+  the default marketing form (picked from the connected portal), not just the
+  private app token. Values saved here override `config/plugins.ts` and env.
+  Switching test → production is an admin change, not a deploy.
+
 ## 0.14.0 — 2026-09-21
 
 ### Changed — native HubSpot form conversions

package/README.md

@@ -365,10 +365,17 @@ its equivalent per object you send to).
 
 ### A settings screen
 
-**Settings → HubSpot** holds the private app token. It is stored server-side and
-never returned to the browser: the UI only receives whether a key exists, where
-it comes from, and its last four characters. A "Test connection" button
-round-trips to HubSpot and reports how many properties it can read.
+**Settings → HubSpot** holds the private app token **and** the HubSpot account
+that receives conversions: portal id, region (`eu1` / `na1`), and the default
+marketing form (picked from the connected portal). Values saved here override
+`config/plugins.ts` and env — switching test → production is an admin change,
+not a deploy.
+
+The token is stored server-side and never returned to the browser: the UI only
+receives whether a key exists, where it comes from, and its last four
+characters. Portal id / region / form GUID are not secrets and round-trip so
+they can be edited. A "Test connection" button round-trips to HubSpot and
+reports how many properties it can read.
 
 Access is gated by a dedicated RBAC permission — **Settings →
 Roles → Plugins → Hubspot**. A role without it neither sees the settings link
@@ -479,11 +486,13 @@ lives on `app-eu1.hubspot.com` and submits to `api-eu1.hsforms.com`. Set
 `config.region` (`eu1`, `na1`, …) to match. Deep links are built from the
 `uiDomain` HubSpot reports for your portal rather than a hardcoded host.
 
-The key is resolved in this order, first match wins:
+The key, portal id, region and default form GUID are resolved in this order,
+first match wins:
 
 1. saved from **Settings → HubSpot**
-2. `config.apiKey` in `config/plugins.ts`
-3. the `HUBSPOT_API_KEY` environment variable
+2. `config/plugins.ts` (`apiKey`, `portalId`, `region`, `forms.defaultFormId`)
+3. environment variables (`HUBSPOT_API_KEY`, `HUBSPOT_PORTAL_ID`,
+   `HUBSPOT_REGION`, `HUBSPOT_DEFAULT_FORM_ID`)
 
 ## Migrating an existing field
 

package/dist/_chunks/{Forms-ws6d8rdC.mjs → Forms-B7eIm0Fi.mjs}

@@ -5,12 +5,12 @@ import { u as useIntl } from "./index-CEh8vkxY.mjs";
 import { Typography, Flex, Box, SingleSelect, SingleSelectOption, MultiSelect, MultiSelectOption, TextInput, IconButton, Button, Combobox, ComboboxOption, Field, Textarea, Checkbox, Divider, Loader, Badge, Table, Thead, Tr, Th, Tbody, Td, Modal } from "@strapi/design-system";
 import { Trash, Plus, ArrowClockwise, ArrowLeft, Drag, ArrowUp, ArrowDown, List, Duplicate, Download } from "@strapi/icons";
 import { useFetchClient } from "@strapi/strapi/admin";
-import { g as getTranslation, P as PLUGIN_ID } from "./index-CPVfElYB.mjs";
+import { g as getTranslation, P as PLUGIN_ID } from "./index-BSJAhj8r.mjs";
 import { useSensors, useSensor, PointerSensor, KeyboardSensor, DndContext, closestCenter } from "@dnd-kit/core";
 import { sortableKeyboardCoordinates, SortableContext, verticalListSortingStrategy, useSortable, arrayMove } from "@dnd-kit/sortable";
 import { CSS } from "@dnd-kit/utilities";
-import { o as objectLabel } from "./objectLabels-6OUnIDB5.mjs";
-import { u as useHubspotSchema } from "./useHubspotSchema-qCUs2gIX.mjs";
+import { o as objectLabel } from "./objectLabels-CrYRzsqe.mjs";
+import { u as useHubspotSchema } from "./useHubspotSchema-CBF4GkmK.mjs";
 const OPERATORS = [
   "eq",
   "neq",

package/dist/_chunks/{Forms-Cch-7zei.js → Forms-ClyI4MJ1.js}

@@ -7,12 +7,12 @@ const index = require("./index-DkTxsEqL.js");
 const designSystem = require("@strapi/design-system");
 const icons = require("@strapi/icons");
 const admin = require("@strapi/strapi/admin");
-const index$1 = require("./index-BlaG8oIq.js");
+const index$1 = require("./index-BpcilDy1.js");
 const core = require("@dnd-kit/core");
 const sortable = require("@dnd-kit/sortable");
 const utilities = require("@dnd-kit/utilities");
-const objectLabels = require("./objectLabels-CPc21Tdd.js");
-const useHubspotSchema = require("./useHubspotSchema-0MvCM1AC.js");
+const objectLabels = require("./objectLabels-CYXXFpNB.js");
+const useHubspotSchema = require("./useHubspotSchema-Ba6xZUCL.js");
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });

package/dist/_chunks/{HubspotFormInput-M2l_8w_e.js → HubspotFormInput-Do7F83V6.js}

@@ -5,7 +5,7 @@ const React = require("react");
 const index = require("./index-DkTxsEqL.js");
 const designSystem = require("@strapi/design-system");
 const admin = require("@strapi/strapi/admin");
-const index$1 = require("./index-BlaG8oIq.js");
+const index$1 = require("./index-BpcilDy1.js");
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });

package/dist/_chunks/{HubspotFormInput-18pWTITT.mjs → HubspotFormInput-cZAiaAaq.mjs}

@@ -3,7 +3,7 @@ import * as React from "react";
 import { u as useIntl } from "./index-CEh8vkxY.mjs";
 import { Field, Flex, Loader, Combobox, ComboboxOption } from "@strapi/design-system";
 import { useFetchClient } from "@strapi/strapi/admin";
-import { P as PLUGIN_ID, g as getTranslation } from "./index-CPVfElYB.mjs";
+import { P as PLUGIN_ID, g as getTranslation } from "./index-BSJAhj8r.mjs";
 const HubspotFormInput = React.forwardRef(
   ({ name, value, onChange, disabled, error, required, label, hint, labelAction }, ref) => {
     const { formatMessage } = useIntl();

package/dist/_chunks/{HubspotObjectInput-BDO99qXs.js → HubspotObjectInput-DWqk2C26.js}

@@ -4,9 +4,9 @@ const jsxRuntime = require("react/jsx-runtime");
 const React = require("react");
 const index = require("./index-DkTxsEqL.js");
 const designSystem = require("@strapi/design-system");
-const index$1 = require("./index-BlaG8oIq.js");
-const objectLabels = require("./objectLabels-CPc21Tdd.js");
-const useHubspotSchema = require("./useHubspotSchema-0MvCM1AC.js");
+const index$1 = require("./index-BpcilDy1.js");
+const objectLabels = require("./objectLabels-CYXXFpNB.js");
+const useHubspotSchema = require("./useHubspotSchema-Ba6xZUCL.js");
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });

package/dist/_chunks/{HubspotObjectInput-DshusXZP.mjs → HubspotObjectInput-ZZk_7hWq.mjs}

@@ -2,9 +2,9 @@ import { jsxs, jsx } from "react/jsx-runtime";
 import * as React from "react";
 import { u as useIntl } from "./index-CEh8vkxY.mjs";
 import { Field, Flex, Loader, SingleSelect, SingleSelectOption } from "@strapi/design-system";
-import { g as getTranslation } from "./index-CPVfElYB.mjs";
-import { o as objectLabel } from "./objectLabels-6OUnIDB5.mjs";
-import { u as useHubspotSchema } from "./useHubspotSchema-qCUs2gIX.mjs";
+import { g as getTranslation } from "./index-BSJAhj8r.mjs";
+import { o as objectLabel } from "./objectLabels-CrYRzsqe.mjs";
+import { u as useHubspotSchema } from "./useHubspotSchema-CBF4GkmK.mjs";
 const HubspotObjectInput = React.forwardRef(
   ({ name, value, onChange, disabled, error, required, label, hint, labelAction }, ref) => {
     const intl = useIntl();

package/dist/_chunks/{HubspotPropertyInput-C-kHDgwx.mjs → HubspotPropertyInput-5bkDGmGo.mjs}

@@ -4,9 +4,9 @@ import { u as useIntl } from "./index-CEh8vkxY.mjs";
 import { Field, Flex, Loader, Combobox, ComboboxOption, IconButton, Button, Typography, Link } from "@strapi/design-system";
 import { ArrowClockwise } from "@strapi/icons";
 import { useField } from "@strapi/strapi/admin";
-import { g as getTranslation } from "./index-CPVfElYB.mjs";
-import { o as objectLabel } from "./objectLabels-6OUnIDB5.mjs";
-import { u as useHubspotSchema } from "./useHubspotSchema-qCUs2gIX.mjs";
+import { g as getTranslation } from "./index-BSJAhj8r.mjs";
+import { o as objectLabel } from "./objectLabels-CrYRzsqe.mjs";
+import { u as useHubspotSchema } from "./useHubspotSchema-CBF4GkmK.mjs";
 const oneLine = {
   display: "block",
   whiteSpace: "nowrap",

package/dist/_chunks/{HubspotPropertyInput-XGnH2tHn.js → HubspotPropertyInput-v9B3wb1a.js}

@@ -6,9 +6,9 @@ const index = require("./index-DkTxsEqL.js");
 const designSystem = require("@strapi/design-system");
 const icons = require("@strapi/icons");
 const admin = require("@strapi/strapi/admin");
-const index$1 = require("./index-BlaG8oIq.js");
-const objectLabels = require("./objectLabels-CPc21Tdd.js");
-const useHubspotSchema = require("./useHubspotSchema-0MvCM1AC.js");
+const index$1 = require("./index-BpcilDy1.js");
+const objectLabels = require("./objectLabels-CYXXFpNB.js");
+const useHubspotSchema = require("./useHubspotSchema-Ba6xZUCL.js");
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });

package/dist/_chunks/{Settings-Bm7WkzK1.mjs → Settings-QcFbm3s5.mjs}

@@ -1,11 +1,11 @@
 import { jsxs, jsx } from "react/jsx-runtime";
 import * as React from "react";
 import { u as useIntl } from "./index-CEh8vkxY.mjs";
-import { Flex, Divider, Typography, Button, Box, Link, Badge, Loader, Field } from "@strapi/design-system";
+import { Flex, Divider, Typography, Button, Box, Link, Badge, Loader, Field, SingleSelect, SingleSelectOption } from "@strapi/design-system";
 import { useFetchClient } from "@strapi/strapi/admin";
-import { g as getTranslation, P as PLUGIN_ID } from "./index-CPVfElYB.mjs";
+import { g as getTranslation, P as PLUGIN_ID } from "./index-BSJAhj8r.mjs";
 import { Link as Link$1 } from "react-router-dom";
-import { o as objectLabel } from "./objectLabels-6OUnIDB5.mjs";
+import { o as objectLabel } from "./objectLabels-CrYRzsqe.mjs";
 const AuditSection = ({ configured }) => {
   const intl = useIntl();
   const { formatMessage } = intl;
@@ -172,19 +172,31 @@ const FailuresSection = ({ configured }) => {
     ) : null
   ] });
 };
+const REGIONS = ["eu1", "na1"];
 const HubspotSettings = () => {
   const { formatMessage } = useIntl();
   const { get, put, del } = useFetchClient();
   const [settings, setSettings] = React.useState(null);
   const [apiKey, setApiKey] = React.useState("");
+  const [portalId, setPortalId] = React.useState("");
+  const [region, setRegion] = React.useState("eu1");
+  const [defaultFormId, setDefaultFormId] = React.useState("");
+  const [forms, setForms] = React.useState([]);
   const [busy, setBusy] = React.useState(false);
   const [feedback, setFeedback] = React.useState(
     null
   );
   const t = (id, defaultMessage, values) => formatMessage({ id: getTranslation(id), defaultMessage }, values);
+  const apply = (data) => {
+    setSettings(data);
+    setPortalId(data.portalId ?? "");
+    setRegion(data.region || "eu1");
+    setDefaultFormId(data.defaultFormId ?? "");
+    setForms(Array.isArray(data.forms) ? data.forms : []);
+  };
   const load = React.useCallback(async () => {
     const { data } = await get(`/${PLUGIN_ID}/settings`);
-    setSettings(data);
+    apply(data);
   }, [get]);
   React.useEffect(() => {
     load().catch(
@@ -195,12 +207,17 @@ const HubspotSettings = () => {
     setBusy(true);
     setFeedback(null);
     try {
-      const { data } = await put(`/${PLUGIN_ID}/settings`, { apiKey });
-      setSettings(data);
+      await put(`/${PLUGIN_ID}/settings`, {
+        ...apiKey.trim() ? { apiKey: apiKey.trim() } : {},
+        portalId,
+        region,
+        defaultFormId
+      });
       setApiKey("");
-      setFeedback({ tone: "success", text: t("settings.saved", "Key saved.") });
+      await load();
+      setFeedback({ tone: "success", text: t("settings.saved", "Settings saved.") });
     } catch {
-      setFeedback({ tone: "danger", text: t("settings.save-error", "Could not save the key.") });
+      setFeedback({ tone: "danger", text: t("settings.save-error", "Could not save settings.") });
     } finally {
       setBusy(false);
     }
@@ -209,9 +226,9 @@ const HubspotSettings = () => {
     setBusy(true);
     setFeedback(null);
     try {
-      const { data } = await del(`/${PLUGIN_ID}/settings`);
-      setSettings(data);
+      await del(`/${PLUGIN_ID}/settings`);
       setApiKey("");
+      await load();
       setFeedback({ tone: "success", text: t("settings.removed", "Key removed.") });
     } catch {
       setFeedback({ tone: "danger", text: t("settings.remove-error", "Could not remove the key.") });
@@ -234,6 +251,7 @@ const HubspotSettings = () => {
           })
         } : { tone: "danger", text: t("settings.test-no-key", "No key configured.") }
       );
+      if (data.configured) await load();
     } catch {
       setFeedback({
         tone: "danger",
@@ -251,44 +269,122 @@ const HubspotSettings = () => {
     config: t("settings.source.config", "config/plugins.ts"),
     env: t("settings.source.env", "environment variable")
   };
+  const sourceHint = (source) => source && source !== "settings" ? /* @__PURE__ */ jsx(Typography, { variant: "pi", textColor: "neutral600", children: t("settings.source", "source: {source}", { source: sourceLabel[source] }) }) : null;
+  const regionOptions = REGIONS.includes(region) ? [...REGIONS] : [region, ...REGIONS];
   return /* @__PURE__ */ jsx(Box, { padding: 8, children: /* @__PURE__ */ jsxs(Flex, { direction: "column", alignItems: "stretch", gap: 6, children: [
     /* @__PURE__ */ jsxs(Flex, { direction: "column", alignItems: "flex-start", gap: 2, children: [
       /* @__PURE__ */ jsx(Typography, { variant: "alpha", children: "HubSpot" }),
       /* @__PURE__ */ jsx(Typography, { variant: "epsilon", textColor: "neutral600", children: t(
         "settings.subtitle",
-        "The private app token used to read the portal's properties and validate form mappings."
+        "Private app token and the HubSpot account that receives form conversions. Switch test → production here — nothing is hardcoded."
       ) })
     ] }),
     /* @__PURE__ */ jsxs(Flex, { gap: 2, alignItems: "center", children: [
       /* @__PURE__ */ jsx(Badge, { active: settings.configured, children: settings.configured ? t("settings.configured", "Configured {hint}", { hint: settings.hint }) : t("settings.not-configured", "Not configured") }),
       settings.keySource ? /* @__PURE__ */ jsx(Typography, { variant: "pi", textColor: "neutral600", children: t("settings.source", "source: {source}", { source: sourceLabel[settings.keySource] }) }) : null
     ] }),
-    /* @__PURE__ */ jsx(Box, { maxWidth: "32rem", children: /* @__PURE__ */ jsxs(
-      Field.Root,
-      {
-        name: "apiKey",
-        hint: t(
-          "settings.key.hint",
-          "A key entered here overrides the ones from config/plugins.ts and HUBSPOT_API_KEY."
+    /* @__PURE__ */ jsx(Box, { maxWidth: "32rem", children: /* @__PURE__ */ jsxs(Flex, { direction: "column", alignItems: "stretch", gap: 4, children: [
+      /* @__PURE__ */ jsxs(
+        Field.Root,
+        {
+          name: "apiKey",
+          hint: t(
+            "settings.key.hint",
+            "A key entered here overrides config/plugins.ts and HUBSPOT_API_KEY."
+          ),
+          children: [
+            /* @__PURE__ */ jsx(Field.Label, { children: t("settings.key.label", "Private app token") }),
+            /* @__PURE__ */ jsx(
+              Field.Input,
+              {
+                type: "password",
+                value: apiKey,
+                autoComplete: "off",
+                placeholder: settings.configured ? t("settings.key.placeholder.set", "•••••••• (leave empty to keep)") : t("settings.key.placeholder.empty", "pat-eu1-…"),
+                onChange: (e) => setApiKey(e.target.value)
+              }
+            ),
+            /* @__PURE__ */ jsx(Field.Hint, {})
+          ]
+        }
+      ),
+      /* @__PURE__ */ jsxs(
+        Field.Root,
+        {
+          name: "portalId",
+          hint: t(
+            "settings.portal.hint",
+            "HubSpot account id (Settings → Account → Account setup). Test portal today, production later."
+          ),
+          children: [
+            /* @__PURE__ */ jsx(Field.Label, { children: t("settings.portal.label", "Portal ID") }),
+            /* @__PURE__ */ jsx(
+              Field.Input,
+              {
+                type: "text",
+                value: portalId,
+                autoComplete: "off",
+                placeholder: "148991818",
+                onChange: (e) => setPortalId(e.target.value)
+              }
+            ),
+            /* @__PURE__ */ jsx(Field.Hint, {}),
+            sourceHint(settings.portalSource)
+          ]
+        }
+      ),
+      /* @__PURE__ */ jsxs(Field.Root, { name: "region", children: [
+        /* @__PURE__ */ jsx(Field.Label, { children: t("settings.region.label", "Region") }),
+        /* @__PURE__ */ jsx(
+          SingleSelect,
+          {
+            value: region,
+            onChange: (value) => setRegion(String(value)),
+            children: regionOptions.map((r) => /* @__PURE__ */ jsx(SingleSelectOption, { value: r, children: r === "eu1" ? t("settings.region.eu1", "Europe (eu1)") : r === "na1" ? t("settings.region.na1", "North America (na1)") : r }, r))
+          }
         ),
-        children: [
-          /* @__PURE__ */ jsx(Field.Label, { children: t("settings.key.label", "Private app token") }),
-          /* @__PURE__ */ jsx(
-            Field.Input,
-            {
-              type: "password",
-              value: apiKey,
-              autoComplete: "off",
-              placeholder: settings.configured ? t("settings.key.placeholder.set", "•••••••• (leave empty to keep)") : t("settings.key.placeholder.empty", "pat-eu1-…"),
-              onChange: (e) => setApiKey(e.target.value)
-            }
+        sourceHint(settings.regionSource)
+      ] }),
+      /* @__PURE__ */ jsxs(
+        Field.Root,
+        {
+          name: "defaultFormId",
+          hint: t(
+            "settings.form.hint",
+            "Marketing form that receives submissions when a builder form doesn't pick its own. Create the form in HubSpot, then pick it here."
           ),
-          /* @__PURE__ */ jsx(Field.Hint, {})
-        ]
-      }
-    ) }),
+          children: [
+            /* @__PURE__ */ jsx(Field.Label, { children: t("settings.form.label", "Default marketing form") }),
+            forms.length ? /* @__PURE__ */ jsxs(
+              SingleSelect,
+              {
+                value: defaultFormId,
+                placeholder: t("settings.form.placeholder", "Pick a form of the connected portal"),
+                onChange: (value) => setDefaultFormId(String(value)),
+                children: [
+                  /* @__PURE__ */ jsx(SingleSelectOption, { value: "", children: t("settings.form.none", "None — CRM upsert only") }),
+                  defaultFormId && !forms.some((f) => f.id === defaultFormId) && /* @__PURE__ */ jsx(SingleSelectOption, { value: defaultFormId, children: defaultFormId }),
+                  forms.map((f) => /* @__PURE__ */ jsx(SingleSelectOption, { value: f.id, children: f.name }, f.id))
+                ]
+              }
+            ) : /* @__PURE__ */ jsx(
+              Field.Input,
+              {
+                type: "text",
+                value: defaultFormId,
+                autoComplete: "off",
+                placeholder: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
+                onChange: (e) => setDefaultFormId(e.target.value.trim())
+              }
+            ),
+            /* @__PURE__ */ jsx(Field.Hint, {}),
+            sourceHint(settings.formSource)
+          ]
+        }
+      )
+    ] }) }),
     /* @__PURE__ */ jsxs(Flex, { gap: 2, children: [
-      /* @__PURE__ */ jsx(Button, { onClick: save, loading: busy, disabled: !apiKey.trim(), children: t("settings.save", "Save") }),
+      /* @__PURE__ */ jsx(Button, { onClick: save, loading: busy, children: t("settings.save", "Save") }),
       /* @__PURE__ */ jsx(Button, { variant: "secondary", onClick: test, loading: busy, disabled: !settings.configured, children: t("settings.test", "Test connection") }),
       /* @__PURE__ */ jsx(
         Button,
@@ -297,7 +393,7 @@ const HubspotSettings = () => {
           onClick: remove,
           loading: busy,
           disabled: settings.keySource !== "settings",
-          children: t("settings.remove", "Remove")
+          children: t("settings.remove", "Remove key")
         }
       )
     ] }),
@@ -311,7 +407,7 @@ const HubspotSettings = () => {
     ) : null,
     /* @__PURE__ */ jsx(Box, { paddingTop: 4, children: /* @__PURE__ */ jsx(Typography, { variant: "pi", textColor: "neutral600", children: t(
       "settings.scopes",
-      "The token needs the crm.schemas.contacts.read and crm.schemas.companies.read scopes to list properties. It is never returned to the browser: only its existence, its source and its last four characters are."
+      "The token needs crm.schemas.contacts.read, crm.schemas.companies.read and forms (to list and submit marketing forms). The token is never returned to the browser."
     ) }) }),
     /* @__PURE__ */ jsx(AuditSection, { configured: settings.configured }),
     /* @__PURE__ */ jsx(FailuresSection, { configured: settings.configured })