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

# nylas workflow list

List workflows

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 list do?

The nylas workflow list command lists workflows. It is part of the Hosted Workflows commands, which automated workflows triggered by Nylas events (e.g., bookings). Use --json for structured output in scripts and automation.

## Usage

```bash
nylas workflow list
```

## Flags

| Flag | Description |
| --- | --- |
| --grant-id string | Grant ID or email for grant-scoped workflows |
| --limit int(-n) | Maximum number of items to show |
| --page-token string | Page token for pagination |
| --scope string | Workflow scope: app or grant |
| --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 |
| --yes(-y) | Skip confirmations |

## Examples

The nylas workflow list command lists workflows.

### JSON output for scripting

```bash
nylas workflow list --json
```

### Limit the number of results

```bash
nylas workflow list --limit 10 --json
```

## Troubleshooting

### Command not found or fails

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

## Related commands

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

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

[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 list --help` for full help output.