Timeline note logging on critical property change (audit visibility)

Outcome. Every time a defined critical deal property changes, a note logs automatically to the deal's timeline with the new value and a timestamp, giving reporting and finance a visible trail without opening the property history panel.

flowchart TD
    A[Deal property Amount changes] --> B[Create note on deal timeline with new value]
    B --> C[Set last_critical_change_logged_at = now]

When to use it / when not to

• Use it for a lightweight, visible audit trail on a small number of high-impact properties, such as deal amount or close date.
• Use it when stakeholders read deal timelines directly and want inline change visibility.
• Do not expect a true before/after log. Native workflow tokens only expose the CURRENT, post-change value, not the prior one. For full before/after diffing, use HubSpot's built-in property history (record page > property > "See history") or a custom-code/webhook approach; see Known pitfalls.
• Do not apply this pattern to every property. A handful of high-signal properties keeps the timeline usable. Logging everything creates noise nobody reads.