HubSpot workflow API limitations, branching patterns, and workarounds. Use when creating or modifying HubSpot workflows, implementing conditional branching, troubleshooting workflow API errors, or automating complex workflow operations. Provides API vs UI decision matrix, LIST_BRANCH workarounds, and validation patterns.
From opspal-hubspotnpx claudepluginhub revpalsfdc/opspal-commercial --plugin opspal-hubspotThis skill is limited to using the following tools:
api-limitations.mdbranching-patterns.mdtesting-patterns.mdworkarounds.mdSearches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.
Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.
| Feature | API Support | Notes |
|---|---|---|
| Contact workflows | ✅ Full | Create, read, update, delete |
| Deal/Company workflows | ❌ None | UI only |
| Simple actions | ✅ Full | Delays, emails, tasks, property updates |
| STATIC_BRANCH | ✅ Full | Single-property splits |
| LIST_BRANCH | ❌ None | API returns 400, use UI |
| AB_TEST_BRANCH | ✅ Full | Random percentage splits |
| List management | ✅ Full | Add to/remove from lists |
| Custom code actions | ✅ Partial | Secrets may require UI |
Cannot create complex if/then branching via API:
HTTP 400 - Invalid request to flow updateWorkaround: Use Playwright browser automation or manual UI
Is it a Contact Workflow?
├─ NO → Use UI (API only supports contacts)
└─ YES → Does it need complex branching?
├─ YES (AND/OR logic) → Use UI automation
└─ NO (single property) → Use API (STATIC_BRANCH)
See supporting files:
api-limitations.md - Known API limitations and workaroundsbranching-patterns.md - STATIC_BRANCH vs LIST_BRANCH patternsworkarounds.md - Playwright and validation solutionstesting-patterns.md - Workflow testing approaches