Command

nylas email folders list

List folders.

Written by Qasim Muhammad Staff SRE

What does nylas email folders list do?

The nylas email folders list command displays all email folders and labels in your connected mailbox — Inbox, Sent, Drafts, Trash, and any custom folders. Works with Gmail labels, Outlook folders, and IMAP mailboxes.

Usage

nylas email folders list

Flags

FlagDescription
--jsonOutput as JSON
--no-colorDisable color output
--verbose(-v)Enable verbose output
--configCustom config file path
--help(-h)Show help for the command
--limitLimit results (most list commands)
--yes(-y)Skip confirmations
--idShow folder IDs

Examples

The nylas email folders list command displays all email folders and labels in your connected mailbox — Inbox, Sent, Drafts, Trash, and any custom folders.

List folders

nylas email folders list

JSON output

nylas email folders list --json

Example output

NAME       UNREAD   TOTAL
INBOX      4        312
SENT       0        198
TRASH      0        27
Archive    0        540

Troubleshooting

Gmail shows labels instead of folders

Gmail uses labels, not folders. The CLI normalizes both as folders. Gmail's system labels (INBOX, SENT, TRASH) appear as folder names.

Custom folders missing

Newly created folders may take a moment to sync. Run `nylas email folders list` again after a few seconds.

Recommended guides

List Fastmail emails from the CLI

List Fastmail emails from the CLI through Nylas IMAP access, using app passwords, inbox filters, JSON output, and Fastmail-specific auth troubleshooting.

Why Cloud Servers Block SMTP Ports

AWS, 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.

Send Email From a Docker Container

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

MailerSend vs Nylas: Email Compared

MailerSend sends transactional email from verified domains. Nylas reads and syncs user inboxes across 6 providers. Compare features, pricing, and use cases.

Customer.io vs Nylas: Email Compared

Customer.io sends lifecycle emails to your user base. Nylas reads and sends from real user inboxes via OAuth. Compare use cases, pricing, and AI agent support.

Knock vs Nylas: Notifications vs Email API

Knock delivers multi-channel product notifications via workflows; Nylas provides two-way email and calendar sync. Compare scope, pricing, and agent support.

Run nylas email folders list --help for full help output.