Use this tool to create a new empty workflow in a monday.com workspace. Workflows are cross-board, workspace-level objects — distinct from automations, which are per-board trigger/action rules (use create_automation for those). You only need a workspaceId to get started; all other fields are optional.

🚧
This tool runs against the monday.com dev (preview) API schema. Workflows start as drafts and must be published with publish_workflow before they run.

The typical workflow-building flow is:

plan_workflow (optional) — Break a complex process into workflows and resources.
create_workflow ← You are here — Create an empty workflow and get its workflowObjectId and workflowDraftId.
update_workflow — Add and modify steps on the draft.
publish_workflow — Promote the draft to the live version.

Parameters

Parameter	Type	Required	Description
workspaceId	`string`	Yes	The ID of the workspace to create the workflow in.
title	`string`	No	Workflow title. Defaults to "New Workflow".
privacyKind	`enum`	No	Visibility: `PUBLIC` (default), `PRIVATE`, or `SHAREABLE` (accessible to guests outside the account).
description	`string`	No	Optional workflow description.
folderId	`string`	No	Optional folder ID to place the workflow in.
ownerIds	`array`	No	Optional list of user IDs to set as workflow owners.

Example

Create a workflow in a workspace:

{
  "workspaceId": "4567890",
  "title": "Deal Onboarding",
  "privacyKind": "PUBLIC"
}

The tool returns workflowObjectId (stable across publishes) and workflowDraftId (the editable draft version). Pass both to update_workflow and publish_workflow.

Programmatic equivalent

This tool maps to the create_workflow mutation on the monday.com dev (preview) API schema. There is no stable public GraphQL equivalent yet.