@revfleet/hscli 0.8.4 → 0.8.5

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # Changelog
 
+## 0.8.5 - 2026-04-23
+
+**Multi-step workflow creation via CLI — legacy v3 unlock.** The v4
+`/automation/v4/flows` endpoint rejects populated `actions[]` on
+create (500) / update (405), which we previously classified as a
+HubSpot platform block. **It isn't.** HubSpot's legacy v3 API
+(`/automation/v3/workflows`) accepts a fully-populated `actions[]`
+array on create — DELAY, EMAIL, SET_CONTACT_PROPERTY, BRANCH,
+WEBHOOK, UPDATE_LIST, TASK, TICKET, DEAL, NOTIFICATION — and
+workflows created via v3 are dual-backed: they surface in v4
+(`migrationStatus.flowId`) and render in HubSpot's modern canvas UI
+with all action nodes visible. Verified live on portal 147975758
+with a 5-step welcome onboarding flow (Trigger → Delay → Send email
+→ Delay → Set property → Branch).
+
+### Added
+
+- **`hscli workflows v3`** subcommand suite:
+  - `v3 list` / `v3 get <id>` — read legacy workflows (includes full
+    `actions[]` tree, which v4 GET omits).
+  - `v3 create --data '{...}'` — create contact-based workflow with
+    populated multi-step actions. One CLI call replaces an entire
+    clicking-through-canvas UI session.
+  - `v3 delete <id>` — archive a workflow.
+  - `v3 enroll <id> <email>` / `v3 unenroll <id> <email>` — manage
+    contact enrollment (automation membership).
+  - `v3 enrollments <email>` — list a contact's current workflow
+    memberships.
+
+### Fixes
+
+- **[docs/CAPABILITY_LIBRARY.md](docs/CAPABILITY_LIBRARY.md)** §5
+  Automation — workflow-action creation reclassified from ❌
+  "API-locked" to ✅ via v3. Full `type`-value catalogue added.
+  §10 blocked-list entry amended: the ❌ on v4 remains, but v3
+  provides the missing workaround.
+
 ## 0.8.4 - 2026-04-23
 
 **Drag-and-drop library access + polish.** A batch of capability-surface

package/dist/commands/workflows/index.d.ts

@@ -1,5 +1,23 @@
 /**
- * `hscli workflows` — v4 flows + legacy v2/v3 workflow enrollment.
+ * `hscli workflows` — v4 flows + legacy v3 workflows.
+ *
+ * Two workflow APIs ship side-by-side on every Marketing-Hub portal:
+ *
+ * - **v4 `/automation/v4/flows`** (current) — returns 500 on POST
+ *   with populated `actions[]` (schema undocumented; verified
+ *   2026-04-23). Works for create-metadata + enrollment triggers
+ *   only.
+ * - **v3 `/automation/v3/workflows`** (legacy, still live) —
+ *   **accepts a populated `actions[]` array with DELAY,
+ *   SET_CONTACT_PROPERTY, BRANCH, EMAIL, WEBHOOK,
+ *   UPDATE_LIST, TASK, TICKET, DEAL, NOTIFICATION, WEBHOOK,
+ *   and more.** Workflows created via v3 are dual-backed: they
+ *   surface in v4 (`migrationStatus.flowId`) and render in the
+ *   modern HubSpot canvas UI with visible action nodes.
+ *
+ * Use `hscli workflows flows` for the v4 surface (enrollment criteria
+ * + metadata) and `hscli workflows v3` for creating multi-step
+ * workflows with real action nodes.
  */
 import { Command } from "commander";
 import type { CliContext } from "../../core/output.js";

package/dist/commands/workflows/index.js

@@ -1,13 +1,93 @@
+import { createClient } from "../../core/http.js";
+import { printResult } from "../../core/output.js";
 import { registerResource } from "../domains/shared.js";
+import { encodePathSegment, maybeWrite, parseJsonPayload, parseNumberFlag } from "../crm/shared.js";
 export function registerWorkflows(program, getCtx) {
     const workflows = program.command("workflows").description("HubSpot Workflow Automation APIs");
     registerResource(workflows, getCtx, {
         name: "flows",
-        description: "Automation flows",
+        description: "Automation flows (v4 API)",
         listPath: "/automation/v4/flows",
         itemPath: (id) => `/automation/v4/flows/${id}`,
         createPath: "/automation/v4/flows",
         updatePath: (id) => `/automation/v4/flows/${id}`,
     });
+    // Legacy v3 workflows — the only public API that accepts
+    // populated multi-step actions on create. Contact-based only.
+    const v3 = workflows.command("v3").description("Legacy v3 workflows API (accepts populated actions[] — contact-based only)");
+    v3.command("list")
+        .option("--limit <n>", "Max workflows (client-side cap; endpoint returns all)", "50")
+        .description("List all v3 workflows")
+        .action(async (o) => {
+        const ctx = getCtx();
+        const client = createClient(ctx.profile);
+        const limit = parseNumberFlag(o.limit, "--limit");
+        const res = (await client.request(`/automation/v3/workflows`));
+        const workflowsArr = (res.workflows) || (res.data?.workflows) || [];
+        printResult(ctx, { total: workflowsArr.length, workflows: workflowsArr.slice(0, limit) });
+    });
+    v3.command("get")
+        .argument("<workflowId>")
+        .description("Get a v3 workflow by id (includes full actions tree)")
+        .action(async (workflowId) => {
+        const ctx = getCtx();
+        const client = createClient(ctx.profile);
+        const id = encodePathSegment(workflowId, "workflowId");
+        const res = await client.request(`/automation/v3/workflows/${id}`);
+        printResult(ctx, res);
+    });
+    v3.command("create")
+        .requiredOption("--data <payload>", "JSON payload. Required: name, type (DRIP_DELAY|STATIC_ANCHOR|PROPERTY_ANCHOR), actions[]. Actions support: DELAY, SET_CONTACT_PROPERTY, BRANCH, EMAIL, WEBHOOK, UPDATE_LIST, TASK, TICKET, DEAL, NOTIFICATION. See https://legacydocs.hubspot.com/docs/methods/workflows/v3/create_workflow")
+        .description("Create a v3 workflow with populated actions (multi-step)")
+        .action(async (o) => {
+        const ctx = getCtx();
+        const client = createClient(ctx.profile);
+        const res = await maybeWrite(ctx, client, "POST", `/automation/v3/workflows`, parseJsonPayload(o.data));
+        printResult(ctx, res);
+    });
+    v3.command("delete")
+        .argument("<workflowId>")
+        .description("Delete a v3 workflow")
+        .action(async (workflowId) => {
+        const ctx = getCtx();
+        const client = createClient(ctx.profile);
+        const id = encodePathSegment(workflowId, "workflowId");
+        const res = await maybeWrite(ctx, client, "DELETE", `/automation/v3/workflows/${id}`);
+        printResult(ctx, res);
+    });
+    v3.command("enroll")
+        .argument("<workflowId>")
+        .argument("<email>")
+        .description("Enroll a contact (by email) in a v3 workflow")
+        .action(async (workflowId, email) => {
+        const ctx = getCtx();
+        const client = createClient(ctx.profile);
+        const id = encodePathSegment(workflowId, "workflowId");
+        const e = encodePathSegment(email, "email");
+        const res = await maybeWrite(ctx, client, "POST", `/automation/v3/workflows/${id}/enrollments/contacts/${e}`);
+        printResult(ctx, res);
+    });
+    v3.command("unenroll")
+        .argument("<workflowId>")
+        .argument("<email>")
+        .description("Remove a contact (by email) from a v3 workflow")
+        .action(async (workflowId, email) => {
+        const ctx = getCtx();
+        const client = createClient(ctx.profile);
+        const id = encodePathSegment(workflowId, "workflowId");
+        const e = encodePathSegment(email, "email");
+        const res = await maybeWrite(ctx, client, "DELETE", `/automation/v3/workflows/${id}/enrollments/contacts/${e}`);
+        printResult(ctx, res);
+    });
+    v3.command("enrollments")
+        .argument("<email>")
+        .description("Get current workflow enrollments for a contact (by email)")
+        .action(async (email) => {
+        const ctx = getCtx();
+        const client = createClient(ctx.profile);
+        const e = encodePathSegment(email, "email");
+        const res = await client.request(`/automation/v3/contacts/${e}/workflowEnrollments`);
+        printResult(ctx, res);
+    });
 }
 //# sourceMappingURL=index.js.map

package/dist/commands/workflows/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/workflows/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,UAAU,iBAAiB,CAAC,OAAgB,EAAE,MAAwB;IAC1E,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,CAAC,kCAAkC,CAAC,CAAC;IAE/F,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE;QAClC,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,kBAAkB;QAC/B,QAAQ,EAAE,sBAAsB;QAChC,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,wBAAwB,EAAE,EAAE;QAC9C,UAAU,EAAE,sBAAsB;QAClC,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,wBAAwB,EAAE,EAAE;KACjD,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/workflows/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revfleet/hscli",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "description": "Agentic HubSpot CLI + MCP server. 100% public API coverage (1180 endpoints, 55+ command domains) — full portal, no UI dependency. Enterprise safety rails, self-hosted.",
   "type": "module",
   "bin": {