> ## Documentation Index
> Fetch the complete documentation index at: https://developers.clay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# workflows create

> Create a new empty workflow.

Create a new empty workflow with the given name. The response returns the new workflow's `id`, `name`, and a `url` that opens it in Clay. Add nodes and tools with the Clay app or the workflow MCP tools.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
clay workflows create --name <name>
```

## Flags

| Flag            | Description                                                            |
| --------------- | ---------------------------------------------------------------------- |
| `--name <name>` | Workflow name. Required. Must be non-empty and at most 255 characters. |

## Output

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "wf_abc123",
  "name": "Lead enrichment",
  "url": "https://app.clay.com/..."
}
```

| Field  | Type   | Description                           |
| ------ | ------ | ------------------------------------- |
| `id`   | string | Id of the new workflow.               |
| `name` | string | Display name.                         |
| `url`  | string | Link that opens the workflow in Clay. |

## Errors

| Code               | Exit | Notes                                                      |
| ------------------ | ---- | ---------------------------------------------------------- |
| `validation_error` | 2    | `--name` is missing, empty, or longer than 255 characters. |
| `auth_forbidden`   | 3    | The API key lacks the `terracotta:cli` scope.              |

## Examples

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
clay workflows create --name "Lead enrichment"
clay workflows create --name "Lead enrichment" | jq -r '.id'
clay workflows create --name "Lead enrichment" | jq -r '.url'
```