Use the HubSpot Automation API to programmatically create a workflow with a Contact enrollment trigger and a sequence of actions including a delay and a property update
domain: hubspot.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
POST to /automation/v4/flows to create a new workflow, providing a 'type' of 'CONTACT_DATE_BASED' or 'CONTACT_PROPERTY_BASED', an enrollment trigger definition specifying the filter criteria, and a time zone
Add an initial ACTION node of type 'DELAY' with the desired duration in the 'actions' array of the flow definition
Add a subsequent ACTION node of type 'SET_CONTACT_PROPERTY' specifying the property name and value to write
Set 'isEnabled' to false initially, then PATCH /automation/v4/flows/{flowId} with 'isEnabled':true to activate after validating the definition
Test enrollment by manually enrolling a contact via POST /automation/v4/flows/{flowId}/enrollments/{contactId} if supported, and monitor execution logs in the UI
Known gotchas
The Automation v4 API is separate from the legacy Workflows v3 API; object schemas and action type names differ between versions and mixing them causes validation errors
Activation via API sets the workflow live immediately for all contacts matching the enrollment trigger who have not yet been enrolled; always test with a narrow filter before enabling
Not all workflow action types available in the HubSpot UI are exposed via the Automation API — complex actions like sending sequences or custom-coded actions may require UI configuration
Give your agent this knowledge — and 15,600+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?