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

# nylas email scheduled list

List emails scheduled for future delivery.

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

Published February 13, 2026

Updated June 21, 2026

## What does nylas email scheduled list do?

The nylas email scheduled list command shows all emails queued for later delivery, including their scheduled send time and recipient. Use it to review or cancel pending scheduled messages.

## Usage

```bash
nylas email scheduled list [--limit N] [--json]
```

## Flags

| Flag | Description |
| --- | --- |
| --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 | Maximum number of scheduled emails to return |
| --yes(-y) | Skip confirmations |

## Examples

The nylas email scheduled list command shows all emails queued for later delivery, including their scheduled send time and recipient.

### List all scheduled emails

```bash
nylas email scheduled list
```

### Cancel a scheduled email

```bash
# First find the scheduled email ID
nylas email scheduled list --json | jq '.[0].id'
# Then delete it before it sends
nylas email delete msg_scheduled_abc123 --force
```

## Example output

```text
ID            SUBJECT          SEND AT
sched_abc123  Q3 planning      2026-06-22 09:00
sched_def456  Morning update   2026-06-23 08:00

2 scheduled messages
```

## Troubleshooting

### Scheduled email already sent even though send time hasn't passed

Scheduled send times are approximate. Messages may be sent a few minutes early depending on provider queue processing.

### No scheduled emails returned

Only emails scheduled via the CLI or Nylas API appear here. Emails scheduled through Gmail or Outlook's built-in scheduler are not tracked.

## Related commands

[nylas email ai analyzeAnalyze recent emails with AI for a summary, categorization, and action items.](https://cli.nylas.com/docs/commands/email-ai-analyze)

[nylas email attachments downloadDownload an attachment](https://cli.nylas.com/docs/commands/email-attachments-download)

[nylas email attachments listList all attachments on a specific email.](https://cli.nylas.com/docs/commands/email-attachments-list)

[nylas email deleteDelete an email by message ID.](https://cli.nylas.com/docs/commands/email-delete)

[nylas email drafts createCreate a new draft email with optional attachments.](https://cli.nylas.com/docs/commands/email-drafts-create)

[nylas email drafts listList email drafts in your mailbox.](https://cli.nylas.com/docs/commands/email-drafts-list)

## Recommended guides

[List Fastmail emails from the CLIList Fastmail emails from the CLI through Nylas IMAP access, using app passwords, inbox filters, JSON output, and Fastmail-specific auth troubleshooting.](https://cli.nylas.com/guides/list-fastmail-emails)

[Why Cloud Servers Block SMTP PortsAWS, GCP, and Azure block outbound SMTP port 25 while ports 587 and 465 stay open. Confirm the block and send email over an HTTPS API instead.](https://cli.nylas.com/guides/smtp-ports-blocked-on-cloud-servers)

[Send Email From a Docker ContainerCloud providers block SMTP port 25 from containers. Send email over an HTTPS API on port 443 with one command and no mail daemon at all.](https://cli.nylas.com/guides/send-email-from-docker-container)

[MailerSend vs Nylas: Email ComparedMailerSend sends transactional email from verified domains. Nylas reads and syncs user inboxes across 6 providers. Compare features, pricing, and use cases.](https://cli.nylas.com/guides/mailersend-vs-nylas)

[Customer.io vs Nylas: Email ComparedCustomer.io sends lifecycle emails to your user base. Nylas reads and sends from real user inboxes via OAuth. Compare use cases, data access, and AI agents.](https://cli.nylas.com/guides/customerio-vs-nylas)

[Knock vs Nylas: Notifications vs Email APIKnock delivers multi-channel product notifications via workflows; Nylas provides two-way email and calendar sync. Compare scope, use cases, and agent support.](https://cli.nylas.com/guides/knock-vs-nylas)

Run `nylas email scheduled list --help` for full help output.