Source: https://cli.nylas.com/docs/commands/workflow-create

# nylas workflow create

Create a workflow

Written by [Qasim Muhammad](https://cli.nylas.com/authors/qasim-muhammad) Staff SRE

Published February 13, 2026

Updated June 21, 2026

## What does nylas workflow create do?

The nylas workflow create command creates a workflow. It is part of the Hosted Workflows commands, which automated workflows triggered by Nylas events (e.g., bookings).

## Usage

```bash
nylas workflow create
```

## Flags

| Flag | Description |
| --- | --- |
| --delay int | Delay in minutes before the workflow sends |
| --disabled | Create the workflow in a disabled state |
| --enabled | Create the workflow in an enabled state |
| --file string | Path to a JSON workflow definition |
| --from-email string | Transactional sender email |
| --from-name string | Transactional sender display name |
| --grant-id string | Grant ID or email for grant-scoped workflows |
| --name string | Workflow name |
| --scope string | Workflow scope: app or grant |
| --template-id string | Hosted template ID |
| --trigger-event string | Workflow trigger event |
| --json | Output as JSON |
| --no-color | Disable color output |
| --verbose(-v) | Enable verbose output |
| --config | Custom config file path |
| --help(-h) | Show help for the command |
| --limit | Limit results (most list commands) |
| --yes(-y) | Skip confirmations |

## Examples

The nylas workflow create command creates a workflow.

### JSON output for scripting

```bash
nylas workflow create --json
```

## Troubleshooting

### Command not found or fails

Run `nylas auth config` and `nylas auth login` to authenticate first.

## Related commands

[nylas workflow deleteDelete a workflow](https://cli.nylas.com/docs/commands/workflow-delete)

[nylas workflow listList workflows](https://cli.nylas.com/docs/commands/workflow-list)

[nylas workflow showShow workflow details](https://cli.nylas.com/docs/commands/workflow-show)

[nylas workflow updateUpdate a workflow](https://cli.nylas.com/docs/commands/workflow-update)

## Recommended guides

[Thunderbird vs Nylas: GUI vs CLI emailThunderbird is a desktop GUI email client with OAuth and calendar built in. Compare it to a scriptable, headless CLI for servers, cron jobs, and AI agents.](https://cli.nylas.com/guides/nylas-vs-thunderbird)

[Build a Vellum Email AgentGive a Vellum workflow email by wrapping the Nylas CLI as a code-node tool — one subprocess call per action, JSON in and out, across 6 providers, no SDK.](https://cli.nylas.com/guides/vellum-email-agent)

[Pipedream vs Nylas for Email AutomationPipedream wires 3,000+ apps with event workflows and code steps. Nylas is a native email API with a CLI for agents and cron. Compare as a Pipedream alternative.](https://cli.nylas.com/guides/pipedream-vs-nylas)

[Detect Calendar Conflicts from the CLISpot double-booked meetings and overlapping events from the terminal. AI conflict detection and jq scripts catch calendar conflicts before they derail your day.](https://cli.nylas.com/guides/detect-calendar-conflicts-cli)

[Block Focus Time on Your Calendar (CLI)Context-switching costs 23 minutes of focus per interruption. Block focus time on Google Calendar from your terminal so meetings can't eat your deep-work slots.](https://cli.nylas.com/guides/block-focus-time-cli)

[Build a Dify Email AgentWrap the Nylas CLI as a Dify custom tool: upload one OpenAPI schema and your Dify email agent reads, searches, and drafts across Gmail, Outlook, and 4 more.](https://cli.nylas.com/guides/dify-email-agent)

Run `nylas workflow create --help` for full help output.