Features

Everything you need to understand why your HubSpot workflows aren't working as expected.

Checkpoint Logging

Capture workflow state at critical points: enrollment, branch decisions, and action execution. Know exactly what data was evaluated at each step.

  • START checkpoint captures workflow entry
  • BRANCH checkpoint records condition evaluation
  • ACTION checkpoint logs before key operations
  • Includes timestamps, property values, and results

Branch Tracing

Visualize exactly which path your workflow took and understand why. See condition evaluations with actual vs expected values.

  • Records which branch path was taken
  • Shows condition property, operator, and expected value
  • Displays actual value at time of evaluation
  • Identifies exactly where workflows diverge

Smart Explanations

Get plain-English explanations of why your workflow didn't do what you expected, complete with evidence and actionable fix suggestions.

  • Clear summary of what happened
  • Most likely cause identification
  • Supporting evidence from logs
  • Actionable fix suggestions

Real-Time Monitoring

Watch your workflows execute in real-time. Logs are captured as each checkpoint is reached, giving you instant visibility.

  • Logs captured instantly via webhook
  • No polling or delays
  • Secure HMAC signature validation
  • Lightweight impact on workflow execution

HubSpot CRM Integration

Automatically fetches deal data from HubSpot to provide richer context in explanations. Understands your CRM state.

  • Fetches deal properties automatically
  • Uses HubSpot Private App authentication
  • Correlates CRM data with checkpoint logs
  • Works even without CRM access (logs-only mode)

Rule-Based Analysis

Fast, deterministic analysis using pattern matching on checkpoint logs. Identifies common workflow issues instantly.

  • Detects missing checkpoints
  • Identifies failed branch conditions
  • Spots action execution errors
  • Recognizes incomplete workflow runs

Common Use Cases

Real scenarios where FlowLens helps you quickly identify and fix workflow issues.

"Why didn't this deal get a task?"

A sales rep expected a follow-up task to be created when a deal moved to a certain stage, but it never appeared.

FlowLens insight: FlowLens shows that the branch condition checked for amount > $10,000, but the deal was only $8,500.

"The email never sent"

An internal notification email should have been sent when a deal closed, but no one received it.

FlowLens insight: FlowLens reveals the workflow started but exited early because the deal owner field was empty.

"Wrong path taken"

A deal went through the wrong workflow branch and received incorrect automation.

FlowLens insight: FlowLens traces the exact branch path and shows which condition evaluated differently than expected.

How It Works

FlowLens integrates seamlessly with your existing HubSpot workflows.

1

Instrument

Add custom code actions at checkpoints

2

Execute

Run your workflow - logs are captured

3

Query

When something goes wrong, call the API

4

Understand

Get explanations with fix suggestions

Ready to debug smarter?

Check out the documentation to get started, or view the source on GitHub.