Cascades Docs
Sign in to run requests with your own sandbox key. Sign in
View as Markdown Open in Claude Open in ChatGPT Add MCP server

MCP tool

cascades_create_workflow

write workflows:write

Create a new cascade (decision workflow) from a JSON definition, owned by the API key's account. Use this to turn a described policy into a runnable cascade: compose the node graph in `definition` and POST it. The cascade is active by default, so you can immediately run it with cascades_trigger_workflow using the returned id — pass active:false to create a draft instead. Sandbox accounts always receive a draft, which still runs in test mode.

REST operation

This tool makes one call: POST /api/v1/workflows — see createWorkflow in the API reference for the full response schema and error codes.

Input schema

ArgumentTypeDescription
name required string
definition any The node graph. Omit or pass `[]` to create an empty draft you fill in later.
use_case string Optional use case label.
trigger_type string API-created cascades default to `manual` so they can be triggered through this API. Unknown values fall back to `manual`.
One of: manual event scheduled
active boolean Whether the cascade is immediately triggerable in live mode. Omitted or `null` means `true`; pass `false` for a draft. Accounts without production access always receive a draft regardless of this value, and the response carries a `note` explaining why.
environment string Target environment: "prod" (default) or "dev".
One of: dev prod

Example

What the model sends, and the JSON the tool returns (the REST response, verbatim).

Call
{
  "name": "cascades_create_workflow",
  "arguments": {
    "name": "Credit-only prescreen",
    "active": false,
    "definition": [
      {
        "id": "credit",
        "type": "BillingProduct",
        "billing_product_code": "TUC1001"
      }
    ]
  }
}
Result
{
  "data": {
    "id": 158,
    "object": "workflow",
    "name": "Credit-only prescreen",
    "active": false
  }
}

Other tools