SKILL.md
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 |