Which CLI

Two different HubSpot CLIs share a confusing resemblance — don't mix them up:

hubspot — the HubSpot agent CLI that this skill library targets. It manages CRM data and automation, and it does have native workflow commands: hubspot workflows list|get|create|update|delete.
hs — the HubSpot developer CLI (@hubspot/cli), for building dev projects: themes, modules, serverless functions, UI extensions, and private apps (hs project, hs upload, hs create). It does not create or manage workflow records.

To create or manage a workflow, use hubspot workflows ... — not hs.

If anything here ever drifts, hubspot workflows --help and hs --help are authoritative.

Resources

File	When to use
`resources/workflow-json-reference.md`	Body shape for create/update — the action graph, branching/convergence, enrollment, full-PUT pitfall
`resources/example-contact-flow.json`	Minimal valid `CONTACT_FLOW` skeleton for `hubspot workflows create --file`
`resources/example-branching-flow.json`	Illustrates branch convergence — two paths pointing `connection.nextActionId` at one shared downstream action