Command

nylas workflow list

List workflows

Written by Qasim Muhammad Staff SRE

Published February 13, 2026Updated 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

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

nylas workflow list --json

Limit the number of results

nylas workflow list --limit 10 --json

Troubleshooting

Command not found or fails

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

Recommended guides

Thunderbird vs Nylas: GUI vs CLI email

Thunderbird 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.

Build a Vellum Email Agent

Give 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.

Pipedream vs Nylas for Email Automation

Pipedream 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.

Detect Calendar Conflicts from the CLI

Spot double-booked meetings and overlapping events from the terminal. AI conflict detection and jq scripts catch calendar conflicts before they derail your day.

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.

Build a Dify Email Agent

Wrap 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.

Run nylas workflow list --help for full help output.