On this page
What HubSpot supports natively
| Route | Builds workflows? | Notes (November 2026) |
|---|---|---|
| Remote HubSpot MCP server | No | No workflow tool is documented |
| HubSpot connector for Claude | No | Claude drafts, you build in HubSpot |
| v4 Automation API (beta) | Yes | Create, read, update, delete; needs the automation scope |
| HubSpot Agent CLI (beta) | Yes | hubspot workflows create and update from a JSON definition, with a --dry-run preview; built for Claude Code, Claude Cowork and Codex |
| Breeze Assistant in the workflow builder | Yes, inside HubSpot | Adds triggers and actions from a prompt; Professional and Enterprise |
The Agent CLI, in beta since June 2026, is HubSpot’s command-line tool for AI agents. It wraps the same create, update and delete operations: Claude Code writes the workflow JSON, previews it with --dry-run, then applies it. It signs in as you with OAuth, or uses a service key for unattended runs, and updates and deletes need a dry-run safety digest first. Like the API, update replaces the whole workflow, so the update trap below applies to both.
The API distinguishes two workflow types: CONTACT_FLOW for contact-based workflows and PLATFORM_FLOW for everything else (deals, tickets, custom objects). A create request includes the actions, enrollment criteria, object type and an isEnabled flag. HubSpot publishes the beta under date-versioned paths, so copy the current path from its reference rather than from an old example.
How to build HubSpot workflows with Claude Code
- Get a credential with the
automationscope. For your own portal, a service key (Development → Keys → Service keys) is the current option for REST calls; an existing legacy private app token also works if it has the scope. Add read scopes for the objects the workflow touches. - Give Claude Code a working example. Build one similar workflow by hand, then have Claude Code fetch it with the API. HubSpot’s action JSON is easier to copy than to describe.
- Have it read the portal’s IDs. Property names, list IDs, owner IDs and pipeline stage IDs from the target portal, not from memory.
- Create it switched off. Send
isEnabled: false, then open the workflow in HubSpot and check triggers, branches and re-enrollment. - Test with one record, then turn it on in HubSpot.
- Keep Claude Code’s command approvals on for anything that writes or deletes.
The update trap
Updating uses PUT with the current revisionId. HubSpot says data from the earlier GET that’s left out of the PUT is removed: omit an action and it’s deleted. Tell Claude Code to fetch, modify and send back the complete definition every time, and never to “just patch one step”. Deletes are permanent through the API.
For the request itself, see how to create a workflow via the HubSpot API.
Claude Code and the API can do the job, but you supply the IDs, the ordering and the checks yourself. To build new workflows, we recommend Jetstack AI Projects; see how Projects compares with Claude and the HubSpot MCP.
Where Jetstack AI fits
If the workflow already exists in another portal, you don’t need to rebuild it. The Jetstack CLI ships a Claude Code setup (a CLAUDE.md and slash commands such as /jetstack-import and /jetstack-deploy) that imports a workflow with its dependencies and deploys it with a reviewed mapping of properties, owners and pipelines; see the CLI docs. You can roll back a Portal reuse deployment: Jetstack shows you what will be removed first, then deletes the assets that deployment created in the destination portal. It won’t delete anything another deployment or Project still uses, and it skips assets that were changed after the deployment. Start from the developer overview.
To build a new workflow, use Projects. Describe it in a brief, for example “when a deal reaches Contract sent, create a task for the owner and set a follow-up date property”. Jetty, the Projects assistant, turns that into a plan you approve, builds the property before the workflow that uses it, and deploys only after a separate approval. The workflow is created switched off, and the receipt confirms what HubSpot saved by reading it back. Projects is currently in limited release; see the quickstart.
Sources
- HubSpot Agent CLI guide, beta (HubSpot Developers)
- Workflows API guide, beta (HubSpot Developers)
- Integrate with the remote HubSpot MCP server (HubSpot Developers)
- Account service keys (HubSpot Developers)
- Jetstack CLI (Jetstack AI documentation)
Checked October 29, 2026. HubSpot changes its products often; tell us at team@jetstack.ai if something here is out of date.
AI, Claude & MCP
Do it from your own code or AI agent.
The Jetstack AI REST API, MCP server and CLI share API keys and scopes. Create and manage those keys in the app.
Read the developer docs