strapi-plugin-hubspot 0.16.2 → 0.16.3

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Unreleased
 
+## 0.16.3 — 2026-09-22
+
+### Changed
+- Timeline recap notes (`forms.timelineNote`, default `true`) now also write
+  after a native Forms API conversion: page URL and originating subject sit
+  on the contact next to the conversion. The Forms API already forwards
+  `context.pageUri` / `pageName`. Toggle lives in Settings → HubSpot.
+
 ## 0.16.2 — 2026-09-22
 
 ### Added

package/README.md

@@ -54,11 +54,14 @@ upserts can share the same plugin:
 | `forms.submissionMode` | `auto` | `auto`: Forms API when a marketing GUID is linked, else CRM upsert. `forms`: always try the Forms API. `crm`: never count as a conversion |
 | `forms.writeExtraProperties` | `true` | After a conversion, CRM-write mapped contact fields the HubSpot form dropped (they 400 the Forms API) |
 | `forms.syncFieldsOnPublish` | `false` | On publish, PATCH missing mapped **contact** fields onto the HubSpot form. Off by default so HubSpot-first installs aren't mutated |
+| `forms.timelineNote` | `true` | Recap note on the contact after a successful sync (page URL, subject, answers). Sits next to a native conversion; turn off if you only want the form submission |
 
-The visitor's `hutk` is forwarded so attribution sticks. Then the contact is
-looked up by email and, when the address is on a corporate domain, the company
-is found-or-created and associated. Timeline notes are opt-in and only used
-on the CRM-upsert path.
+The visitor's `hutk` is forwarded so attribution sticks. The conversion carries
+`context.pageUri` / `pageName` (the page the visitor submitted from). Then the
+contact is looked up by email and, when the address is on a corporate domain,
+the company is found-or-created and associated. Timeline notes (`forms.timelineNote`,
+default `true`) add a recap of that page plus the originating subject on the
+contact timeline — they don't replace the conversion.
 
 CRM properties are **never created**. Map to properties that already exist in
 the portal; opting into field sync only adds form fields that point at those
@@ -75,7 +78,7 @@ hubspot: {
     region: env("HUBSPOT_REGION", "eu1"),     // eu1 → api-eu1.hsforms.com
     forms: {
       companyFromDomain: true, // Company by corporate domain + association
-      timelineNote: false,     // recap note on the CRM-upsert fallback only
+      timelineNote: true,      // recap note (page + subject) next to the conversion
       defaultFormId: env("HUBSPOT_DEFAULT_FORM_ID", ""),
       submissionMode: "auto",  // auto | forms | crm
       writeExtraProperties: true,

package/dist/_chunks/{Forms-BOQWely0.mjs → Forms-BBaw53Tz.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-CLAy5dVN.mjs";
+import { g as getTranslation, P as PLUGIN_ID } from "./index-B8GYi6sw.mjs";
 import { useSensors, useSensor, PointerSensor, KeyboardSensor, DndContext, useDroppable, closestCorners } from "@dnd-kit/core";
 import { arrayMove, sortableKeyboardCoordinates, SortableContext, verticalListSortingStrategy, useSortable } from "@dnd-kit/sortable";
 import { CSS } from "@dnd-kit/utilities";
-import { o as objectLabel } from "./objectLabels--zOmqsfm.mjs";
-import { u as useHubspotSchema } from "./useHubspotSchema-Bz2o1BU-.mjs";
+import { o as objectLabel } from "./objectLabels-DybqhBdT.mjs";
+import { u as useHubspotSchema } from "./useHubspotSchema-DtcHHUOb.mjs";
 const OPERATORS = [
   "eq",
   "neq",

package/dist/_chunks/{Forms-mMNP7hc9.js → Forms-CIJrUB_n.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-R3ReZXF1.js");
+const index$1 = require("./index-XEuSPuUj.js");
 const core = require("@dnd-kit/core");
 const sortable = require("@dnd-kit/sortable");
 const utilities = require("@dnd-kit/utilities");
-const objectLabels = require("./objectLabels-CW2iBOkD.js");
-const useHubspotSchema = require("./useHubspotSchema-BRzzvs9t.js");
+const objectLabels = require("./objectLabels-wBwfLdZt.js");
+const useHubspotSchema = require("./useHubspotSchema-WvgW3od8.js");
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });

package/dist/_chunks/{HubspotFormInput-DCkoavrN.mjs → HubspotFormInput-DIo6hCNz.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-CLAy5dVN.mjs";
+import { P as PLUGIN_ID, g as getTranslation } from "./index-B8GYi6sw.mjs";
 const HubspotFormInput = React.forwardRef(
   ({ name, value, onChange, disabled, error, required, label, hint, labelAction }, ref) => {
     const { formatMessage } = useIntl();

package/dist/_chunks/{HubspotFormInput-DI35Aqiu.js → HubspotFormInput-DSTuQ_bx.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-R3ReZXF1.js");
+const index$1 = require("./index-XEuSPuUj.js");
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });

package/dist/_chunks/{HubspotObjectInput-BbnvhdbD.mjs → HubspotObjectInput-BA16dswz.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-CLAy5dVN.mjs";
-import { o as objectLabel } from "./objectLabels--zOmqsfm.mjs";
-import { u as useHubspotSchema } from "./useHubspotSchema-Bz2o1BU-.mjs";
+import { g as getTranslation } from "./index-B8GYi6sw.mjs";
+import { o as objectLabel } from "./objectLabels-DybqhBdT.mjs";
+import { u as useHubspotSchema } from "./useHubspotSchema-DtcHHUOb.mjs";
 const HubspotObjectInput = React.forwardRef(
   ({ name, value, onChange, disabled, error, required, label, hint, labelAction }, ref) => {
     const intl = useIntl();

package/dist/_chunks/{HubspotObjectInput-Cq1TuL_l.js → HubspotObjectInput-BIqC8tl2.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-R3ReZXF1.js");
-const objectLabels = require("./objectLabels-CW2iBOkD.js");
-const useHubspotSchema = require("./useHubspotSchema-BRzzvs9t.js");
+const index$1 = require("./index-XEuSPuUj.js");
+const objectLabels = require("./objectLabels-wBwfLdZt.js");
+const useHubspotSchema = require("./useHubspotSchema-WvgW3od8.js");
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });

package/dist/_chunks/{HubspotPropertyInput-BLZzsW08.js → HubspotPropertyInput-C77Op1Wm.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-R3ReZXF1.js");
-const objectLabels = require("./objectLabels-CW2iBOkD.js");
-const useHubspotSchema = require("./useHubspotSchema-BRzzvs9t.js");
+const index$1 = require("./index-XEuSPuUj.js");
+const objectLabels = require("./objectLabels-wBwfLdZt.js");
+const useHubspotSchema = require("./useHubspotSchema-WvgW3od8.js");
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });

package/dist/_chunks/{HubspotPropertyInput-BHfpBD36.mjs → HubspotPropertyInput-Dsn7ikop.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-CLAy5dVN.mjs";
-import { o as objectLabel } from "./objectLabels--zOmqsfm.mjs";
-import { u as useHubspotSchema } from "./useHubspotSchema-Bz2o1BU-.mjs";
+import { g as getTranslation } from "./index-B8GYi6sw.mjs";
+import { o as objectLabel } from "./objectLabels-DybqhBdT.mjs";
+import { u as useHubspotSchema } from "./useHubspotSchema-DtcHHUOb.mjs";
 const oneLine = {
   display: "block",
   whiteSpace: "nowrap",

package/dist/_chunks/{Settings-DqRpHtnT.mjs → Settings-DxX9Uh_2.mjs}

@@ -3,9 +3,9 @@ import * as React from "react";
 import { u as useIntl } from "./index-CEh8vkxY.mjs";
 import { Flex, Divider, Typography, Button, Box, Link, Badge, Loader, Field, SingleSelect, SingleSelectOption, Checkbox } from "@strapi/design-system";
 import { useFetchClient } from "@strapi/strapi/admin";
-import { g as getTranslation, P as PLUGIN_ID } from "./index-CLAy5dVN.mjs";
+import { g as getTranslation, P as PLUGIN_ID } from "./index-B8GYi6sw.mjs";
 import { Link as Link$1 } from "react-router-dom";
-import { o as objectLabel } from "./objectLabels--zOmqsfm.mjs";
+import { o as objectLabel } from "./objectLabels-DybqhBdT.mjs";
 const AuditSection = ({ configured }) => {
   const intl = useIntl();
   const { formatMessage } = intl;
@@ -184,6 +184,7 @@ const HubspotSettings = () => {
   const [submissionMode, setSubmissionMode] = React.useState("auto");
   const [writeExtraProperties, setWriteExtraProperties] = React.useState(true);
   const [syncFieldsOnPublish, setSyncFieldsOnPublish] = React.useState(false);
+  const [timelineNote, setTimelineNote] = React.useState(true);
   const [forms, setForms] = React.useState([]);
   const [busy, setBusy] = React.useState(false);
   const [feedback, setFeedback] = React.useState(
@@ -198,6 +199,7 @@ const HubspotSettings = () => {
     setSubmissionMode(data.submissionMode === "crm" || data.submissionMode === "forms" ? data.submissionMode : "auto");
     setWriteExtraProperties(data.writeExtraProperties !== false);
     setSyncFieldsOnPublish(data.syncFieldsOnPublish === true);
+    setTimelineNote(data.timelineNote !== false);
     setForms(Array.isArray(data.forms) ? data.forms : []);
   };
   const load = React.useCallback(async () => {
@@ -220,7 +222,8 @@ const HubspotSettings = () => {
         defaultFormId,
         submissionMode,
         writeExtraProperties,
-        syncFieldsOnPublish
+        syncFieldsOnPublish,
+        timelineNote
       });
       setApiKey("");
       await load();
@@ -454,6 +457,21 @@ const HubspotSettings = () => {
       /* @__PURE__ */ jsx(Typography, { variant: "pi", textColor: "neutral600", children: t(
         "settings.sync.hint",
         "Strapi-first installs: a field added here appears on the HubSpot form next publish. HubSpot-first installs should leave this off — importing a form already carries its fields. Properties themselves are never created; map to ones that exist in the portal."
+      ) }),
+      /* @__PURE__ */ jsx(
+        Checkbox,
+        {
+          checked: timelineNote,
+          onCheckedChange: (checked) => setTimelineNote(checked === true),
+          children: t(
+            "settings.note.label",
+            "Also write a recap note on the contact (page, subject, answers)"
+          )
+        }
+      ),
+      /* @__PURE__ */ jsx(Typography, { variant: "pi", textColor: "neutral600", children: t(
+        "settings.note.hint",
+        "The conversion already carries the page URL (pageUri). The note puts that page plus the originating subject on the contact timeline, next to the native form submission."
       ) })
     ] }) }),
     /* @__PURE__ */ jsxs(Flex, { gap: 2, children: [

package/dist/_chunks/{Settings-BAsx0LGv.js → Settings-PVhJVPqq.js}

@@ -5,9 +5,9 @@ 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-R3ReZXF1.js");
+const index$1 = require("./index-XEuSPuUj.js");
 const reactRouterDom = require("react-router-dom");
-const objectLabels = require("./objectLabels-CW2iBOkD.js");
+const objectLabels = require("./objectLabels-wBwfLdZt.js");
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });
@@ -204,6 +204,7 @@ const HubspotSettings = () => {
   const [submissionMode, setSubmissionMode] = React__namespace.useState("auto");
   const [writeExtraProperties, setWriteExtraProperties] = React__namespace.useState(true);
   const [syncFieldsOnPublish, setSyncFieldsOnPublish] = React__namespace.useState(false);
+  const [timelineNote, setTimelineNote] = React__namespace.useState(true);
   const [forms, setForms] = React__namespace.useState([]);
   const [busy, setBusy] = React__namespace.useState(false);
   const [feedback, setFeedback] = React__namespace.useState(
@@ -218,6 +219,7 @@ const HubspotSettings = () => {
     setSubmissionMode(data.submissionMode === "crm" || data.submissionMode === "forms" ? data.submissionMode : "auto");
     setWriteExtraProperties(data.writeExtraProperties !== false);
     setSyncFieldsOnPublish(data.syncFieldsOnPublish === true);
+    setTimelineNote(data.timelineNote !== false);
     setForms(Array.isArray(data.forms) ? data.forms : []);
   };
   const load = React__namespace.useCallback(async () => {
@@ -240,7 +242,8 @@ const HubspotSettings = () => {
         defaultFormId,
         submissionMode,
         writeExtraProperties,
-        syncFieldsOnPublish
+        syncFieldsOnPublish,
+        timelineNote
       });
       setApiKey("");
       await load();
@@ -474,6 +477,21 @@ const HubspotSettings = () => {
       /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "pi", textColor: "neutral600", children: t(
         "settings.sync.hint",
         "Strapi-first installs: a field added here appears on the HubSpot form next publish. HubSpot-first installs should leave this off — importing a form already carries its fields. Properties themselves are never created; map to ones that exist in the portal."
+      ) }),
+      /* @__PURE__ */ jsxRuntime.jsx(
+        designSystem.Checkbox,
+        {
+          checked: timelineNote,
+          onCheckedChange: (checked) => setTimelineNote(checked === true),
+          children: t(
+            "settings.note.label",
+            "Also write a recap note on the contact (page, subject, answers)"
+          )
+        }
+      ),
+      /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "pi", textColor: "neutral600", children: t(
+        "settings.note.hint",
+        "The conversion already carries the page URL (pageUri). The note puts that page plus the originating subject on the contact timeline, next to the native form submission."
       ) })
     ] }) }),
     /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Flex, { gap: 2, children: [

package/dist/_chunks/{index-CLAy5dVN.mjs → index-B8GYi6sw.mjs}

@@ -25,7 +25,7 @@ const index = {
       icon: PaperPlane,
       intlLabel: { id: `${PLUGIN_ID}.menu.label`, defaultMessage: "HubSpot Forms" },
       permissions: [{ action: `plugin::${PLUGIN_ID}.forms`, subject: null }],
-      Component: async () => (await import("./Forms-BOQWely0.mjs")).default
+      Component: async () => (await import("./Forms-BBaw53Tz.mjs")).default
     });
     app.customFields.register({
       name: "property",
@@ -40,7 +40,7 @@ const index = {
         defaultMessage: "Picked from the portal's real properties"
       },
       components: {
-        Input: async () => import("./HubspotPropertyInput-BHfpBD36.mjs")
+        Input: async () => import("./HubspotPropertyInput-Dsn7ikop.mjs")
       },
       // Exposed in the Content-Type Builder. Without this, `objectField` could
       // only be set by hand-editing schema.json — which is not how anyone
@@ -103,7 +103,7 @@ const index = {
         defaultMessage: "Picked from the portal's configured objects"
       },
       components: {
-        Input: async () => import("./HubspotObjectInput-BbnvhdbD.mjs")
+        Input: async () => import("./HubspotObjectInput-BA16dswz.mjs")
       }
     });
     app.customFields.register({
@@ -119,7 +119,7 @@ const index = {
         defaultMessage: "A form built in the HubSpot form builder, stored by slug"
       },
       components: {
-        Input: async () => import("./HubspotFormInput-DCkoavrN.mjs")
+        Input: async () => import("./HubspotFormInput-DIo6hCNz.mjs")
       }
     });
     app.createSettingSection(
@@ -135,7 +135,7 @@ const index = {
           // Mirrors the RBAC action registered server-side: a role without it
           // doesn't see the link at all — the routes refuse it anyway.
           permissions: [{ action: `plugin::${PLUGIN_ID}.settings`, subject: null }],
-          Component: async () => (await import("./Settings-DqRpHtnT.mjs")).default
+          Component: async () => (await import("./Settings-DxX9Uh_2.mjs")).default
         }
       ]
     );

package/dist/_chunks/{index-R3ReZXF1.js → index-XEuSPuUj.js}

@@ -26,7 +26,7 @@ const index = {
       icon: icons.PaperPlane,
       intlLabel: { id: `${PLUGIN_ID}.menu.label`, defaultMessage: "HubSpot Forms" },
       permissions: [{ action: `plugin::${PLUGIN_ID}.forms`, subject: null }],
-      Component: async () => (await Promise.resolve().then(() => require("./Forms-mMNP7hc9.js"))).default
+      Component: async () => (await Promise.resolve().then(() => require("./Forms-CIJrUB_n.js"))).default
     });
     app.customFields.register({
       name: "property",
@@ -41,7 +41,7 @@ const index = {
         defaultMessage: "Picked from the portal's real properties"
       },
       components: {
-        Input: async () => Promise.resolve().then(() => require("./HubspotPropertyInput-BLZzsW08.js"))
+        Input: async () => Promise.resolve().then(() => require("./HubspotPropertyInput-C77Op1Wm.js"))
       },
       // Exposed in the Content-Type Builder. Without this, `objectField` could
       // only be set by hand-editing schema.json — which is not how anyone
@@ -104,7 +104,7 @@ const index = {
         defaultMessage: "Picked from the portal's configured objects"
       },
       components: {
-        Input: async () => Promise.resolve().then(() => require("./HubspotObjectInput-Cq1TuL_l.js"))
+        Input: async () => Promise.resolve().then(() => require("./HubspotObjectInput-BIqC8tl2.js"))
       }
     });
     app.customFields.register({
@@ -120,7 +120,7 @@ const index = {
         defaultMessage: "A form built in the HubSpot form builder, stored by slug"
       },
       components: {
-        Input: async () => Promise.resolve().then(() => require("./HubspotFormInput-DI35Aqiu.js"))
+        Input: async () => Promise.resolve().then(() => require("./HubspotFormInput-DSTuQ_bx.js"))
       }
     });
     app.createSettingSection(
@@ -136,7 +136,7 @@ const index = {
           // Mirrors the RBAC action registered server-side: a role without it
           // doesn't see the link at all — the routes refuse it anyway.
           permissions: [{ action: `plugin::${PLUGIN_ID}.settings`, subject: null }],
-          Component: async () => (await Promise.resolve().then(() => require("./Settings-BAsx0LGv.js"))).default
+          Component: async () => (await Promise.resolve().then(() => require("./Settings-PVhJVPqq.js"))).default
         }
       ]
     );

package/dist/_chunks/{objectLabels--zOmqsfm.mjs → objectLabels-DybqhBdT.mjs}

@@ -1,4 +1,4 @@
-import { g as getTranslation } from "./index-CLAy5dVN.mjs";
+import { g as getTranslation } from "./index-B8GYi6sw.mjs";
 const STANDARD = /* @__PURE__ */ new Set([
   "contact",
   "company",

package/dist/_chunks/{objectLabels-CW2iBOkD.js → objectLabels-wBwfLdZt.js}

@@ -1,5 +1,5 @@
 "use strict";
-const index = require("./index-R3ReZXF1.js");
+const index = require("./index-XEuSPuUj.js");
 const STANDARD = /* @__PURE__ */ new Set([
   "contact",
   "company",

package/dist/_chunks/{useHubspotSchema-Bz2o1BU-.mjs → useHubspotSchema-DtcHHUOb.mjs}

@@ -1,6 +1,6 @@
 import * as React from "react";
 import { useFetchClient } from "@strapi/strapi/admin";
-import { P as PLUGIN_ID } from "./index-CLAy5dVN.mjs";
+import { P as PLUGIN_ID } from "./index-B8GYi6sw.mjs";
 let cached = null;
 let inFlight = null;
 const listeners = /* @__PURE__ */ new Set();

package/dist/_chunks/{useHubspotSchema-BRzzvs9t.js → useHubspotSchema-WvgW3od8.js}

@@ -1,7 +1,7 @@
 "use strict";
 const React = require("react");
 const admin = require("@strapi/strapi/admin");
-const index = require("./index-R3ReZXF1.js");
+const index = require("./index-XEuSPuUj.js");
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });

package/dist/admin/index.js

@@ -1,4 +1,4 @@
 "use strict";
-const index = require("../_chunks/index-R3ReZXF1.js");
+const index = require("../_chunks/index-XEuSPuUj.js");
 require("@strapi/icons");
 module.exports = index.index;

package/dist/admin/index.mjs

@@ -1,4 +1,4 @@
-import { i } from "../_chunks/index-CLAy5dVN.mjs";
+import { i } from "../_chunks/index-B8GYi6sw.mjs";
 import "@strapi/icons";
 export {
   i as default

package/dist/server/index.js

@@ -191,7 +191,8 @@ function policyFrom(stored, forms) {
   return {
     submissionMode: asSubmissionMode(stored.submissionMode) ?? asSubmissionMode(forms.submissionMode) ?? "auto",
     writeExtraProperties: asBool(stored.writeExtraProperties) ?? asBool(forms.writeExtraProperties) ?? true,
-    syncFieldsOnPublish: asBool(stored.syncFieldsOnPublish) ?? asBool(forms.syncFieldsOnPublish) ?? false
+    syncFieldsOnPublish: asBool(stored.syncFieldsOnPublish) ?? asBool(forms.syncFieldsOnPublish) ?? false,
+    timelineNote: asBool(stored.timelineNote) ?? asBool(forms.timelineNote) ?? true
   };
 }
 async function resolvePolicy(strapi) {
@@ -275,6 +276,9 @@ async function patchStoredSettings(strapi, body) {
   if ("syncFieldsOnPublish" in body && typeof body.syncFieldsOnPublish === "boolean") {
     next.syncFieldsOnPublish = body.syncFieldsOnPublish;
   }
+  if ("timelineNote" in body && typeof body.timelineNote === "boolean") {
+    next.timelineNote = body.timelineNote;
+  }
   await setStoredSettings(strapi, next);
 }
 async function clearStoredApiKey(strapi) {
@@ -2445,7 +2449,7 @@ function createFormsService(strapi, _opts = {}) {
             context: {
               hutk: sanitizeHutk(meta.hutk),
               pageUri: typeof meta.pageUrl === "string" ? meta.pageUrl : void 0,
-              pageName: typeof meta.pageName === "string" && meta.pageName || (form.title || form.name) || void 0,
+              pageName: typeof meta.pageName === "string" && meta.pageName || typeof meta.originLabel === "string" && meta.originLabel || (form.title || form.name) || void 0,
               ipAddress: sanitizeIp(meta.ipAddress)
             },
             consent: { given: meta.consent === true },
@@ -2525,7 +2529,7 @@ function createFormsService(strapi, _opts = {}) {
           strapi.log.warn(`[hubspot] company sync failed (contact OK) — ${err.message}`);
         }
       }
-      if (contactId && config2.timelineNote && !usedFormsApi) {
+      if (contactId && policy.timelineNote) {
         try {
           await createLeadNote(apiKey, {
             contactId,
@@ -3334,8 +3338,8 @@ const config = {
     // Submission pipeline of the built forms:
     //  - companyFromDomain: a corporate email upserts the Company (deduped by
     //    domain) and associates it to the contact;
-    //  - timelineNote: recap note on the CRM-upsert fallback only (off when
-    //    submissions go through the marketing Forms API);
+    //  - timelineNote: recap note on the contact after a successful sync
+    //    (page URL, subject, answers) — alongside a Forms API conversion;
     //  - defaultFormId: portal-wide marketing form GUID when a builder form
     //    doesn't set its own — swap with the portal at production cutover.
     //  - submissionMode / writeExtraProperties / syncFieldsOnPublish: see

package/dist/server/index.mjs

@@ -190,7 +190,8 @@ function policyFrom(stored, forms) {
   return {
     submissionMode: asSubmissionMode(stored.submissionMode) ?? asSubmissionMode(forms.submissionMode) ?? "auto",
     writeExtraProperties: asBool(stored.writeExtraProperties) ?? asBool(forms.writeExtraProperties) ?? true,
-    syncFieldsOnPublish: asBool(stored.syncFieldsOnPublish) ?? asBool(forms.syncFieldsOnPublish) ?? false
+    syncFieldsOnPublish: asBool(stored.syncFieldsOnPublish) ?? asBool(forms.syncFieldsOnPublish) ?? false,
+    timelineNote: asBool(stored.timelineNote) ?? asBool(forms.timelineNote) ?? true
   };
 }
 async function resolvePolicy(strapi) {
@@ -274,6 +275,9 @@ async function patchStoredSettings(strapi, body) {
   if ("syncFieldsOnPublish" in body && typeof body.syncFieldsOnPublish === "boolean") {
     next.syncFieldsOnPublish = body.syncFieldsOnPublish;
   }
+  if ("timelineNote" in body && typeof body.timelineNote === "boolean") {
+    next.timelineNote = body.timelineNote;
+  }
   await setStoredSettings(strapi, next);
 }
 async function clearStoredApiKey(strapi) {
@@ -2444,7 +2448,7 @@ function createFormsService(strapi, _opts = {}) {
             context: {
               hutk: sanitizeHutk(meta.hutk),
               pageUri: typeof meta.pageUrl === "string" ? meta.pageUrl : void 0,
-              pageName: typeof meta.pageName === "string" && meta.pageName || (form.title || form.name) || void 0,
+              pageName: typeof meta.pageName === "string" && meta.pageName || typeof meta.originLabel === "string" && meta.originLabel || (form.title || form.name) || void 0,
               ipAddress: sanitizeIp(meta.ipAddress)
             },
             consent: { given: meta.consent === true },
@@ -2524,7 +2528,7 @@ function createFormsService(strapi, _opts = {}) {
           strapi.log.warn(`[hubspot] company sync failed (contact OK) — ${err.message}`);
         }
       }
-      if (contactId && config2.timelineNote && !usedFormsApi) {
+      if (contactId && policy.timelineNote) {
         try {
           await createLeadNote(apiKey, {
             contactId,
@@ -3333,8 +3337,8 @@ const config = {
     // Submission pipeline of the built forms:
     //  - companyFromDomain: a corporate email upserts the Company (deduped by
     //    domain) and associates it to the contact;
-    //  - timelineNote: recap note on the CRM-upsert fallback only (off when
-    //    submissions go through the marketing Forms API);
+    //  - timelineNote: recap note on the contact after a successful sync
+    //    (page URL, subject, answers) — alongside a Forms API conversion;
     //  - defaultFormId: portal-wide marketing form GUID when a builder form
     //    doesn't set its own — swap with the portal at production cutover.
     //  - submissionMode / writeExtraProperties / syncFieldsOnPublish: see

package/dist/server/src/forms.d.ts

@@ -6,8 +6,9 @@
  * conversion (with leftover CRM writes for mapped fields the HubSpot form
  * dropped), CRM upsert only, or automatic (Forms API when a GUID is linked).
  * Company find-or-create still runs after a successful submit. Timeline notes
- * are opt-in and only used on the CRM-upsert path. The form submission is
- * the lead — a CRM outage never loses it.
+ * (page URL, subject, answers) are optional extra context on the contact,
+ * alongside a native conversion. The form submission is the lead — a CRM
+ * outage never loses it.
  */
 import type { Core } from "@strapi/strapi";
 import { type FormDefinition, type Primitive } from "./conditions";

package/dist/server/src/index.d.ts

@@ -371,6 +371,7 @@ declare const _default: {
                         submissionMode?: string;
                         writeExtraProperties?: boolean;
                         syncFieldsOnPublish?: boolean;
+                        timelineNote?: boolean;
                     };
                 };
                 body: unknown;

package/dist/server/src/settings.d.ts

@@ -24,6 +24,7 @@ export interface StoredSettings {
     submissionMode?: SubmissionMode;
     writeExtraProperties?: boolean;
     syncFieldsOnPublish?: boolean;
+    timelineNote?: boolean;
 }
 export interface HubspotPolicy {
     /** How submissions reach HubSpot. `auto` uses Forms API when a GUID is set. */
@@ -32,6 +33,8 @@ export interface HubspotPolicy {
     writeExtraProperties: boolean;
     /** On publish, PATCH missing mapped contact fields onto the HubSpot form. */
     syncFieldsOnPublish: boolean;
+    /** Recap note on the contact (page URL, subject, answers) after a successful sync. */
+    timelineNote: boolean;
 }
 export interface PublicSettings {
     configured: boolean;
@@ -48,6 +51,7 @@ export interface PublicSettings {
     submissionMode: SubmissionMode;
     writeExtraProperties: boolean;
     syncFieldsOnPublish: boolean;
+    timelineNote: boolean;
 }
 export interface HubspotAccount {
     portalId: string;
@@ -62,6 +66,7 @@ interface FormsCfg {
     submissionMode?: unknown;
     writeExtraProperties?: unknown;
     syncFieldsOnPublish?: unknown;
+    timelineNote?: unknown;
 }
 export declare function policyFrom(stored: StoredSettings, forms: FormsCfg): HubspotPolicy;
 export declare function resolvePolicy(strapi: Core.Strapi): Promise<HubspotPolicy>;
@@ -80,6 +85,7 @@ export interface SettingsPatch {
     submissionMode?: unknown;
     writeExtraProperties?: unknown;
     syncFieldsOnPublish?: unknown;
+    timelineNote?: unknown;
 }
 /** Merge a PATCH-like body into the store without dropping the saved key. */
 export declare function patchStoredSettings(strapi: Core.Strapi, body: SettingsPatch): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strapi-plugin-hubspot",
-  "version": "0.16.2",
+  "version": "0.16.3",
   "description": "The form builder for HubSpot in Strapi — multi-step forms with conditional fields mapped to real CRM properties, a public submit pipeline with retries, and save-time mapping validation.",
   "keywords": [
     "strapi",