---
title: WorkflowCreateRequest schema
description: Fields of the WorkflowCreateRequest object in the Cascades API.
canonical_url: "https://cascades.crscreditapi.com/docs/api/schemas/WorkflowCreateRequest"
doc_version: "1.0.0"
last_updated: "2026-10-09T18:04:24Z"
source: "public/api-docs/v1/swagger.yaml#/components/schemas/WorkflowCreateRequest"
---

# WorkflowCreateRequest

Defined in [openapi.json](https://cascades.crscreditapi.com/openapi.json#/components/schemas/WorkflowCreateRequest) ([YAML](https://cascades.crscreditapi.com/openapi.yaml)).

| Field | Type | Required | Description |
|---|---|---|---|
| `name` | string | yes |  |
| `definition` | CascadeDefinition | no | The node graph. Omit or pass `[]` to create an empty draft you fill in later. |
| `use_case` | string | no | Optional use case label. |
| `trigger_type` | string | no | 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 | no | 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. |

```json
{
  "name": "Tenant Screening Standard",
  "definition": "value",
  "use_case": "tenant_screening",
  "trigger_type": "manual",
  "active": true
}
```

## Sitemap

See the full [sitemap](https://cascades.crscreditapi.com/sitemap.md) for all pages.