Command

nylas email threads list

List threads.

Written by Qasim Muhammad Staff SRE

What does nylas email threads list do?

The nylas email threads list command displays email conversation threads from your connected mailbox. Each thread groups related messages together, showing the latest message, participant count, and subject. Use --json for scripting.

Usage

nylas email threads 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 thread IDs
--starred(-s)Only show starred threads
--subjectFilter by subject
--unread(-u)Only show unread threads

Examples

The nylas email threads list command displays email conversation threads from your connected mailbox.

List threads

nylas email threads list

JSON output

nylas email threads list --json --limit 20

Example output

SUBJECT              MESSAGES   LAST ACTIVITY
Q3 planning          5          2026-06-21 09:14
Re: Invoice #482     3          2026-06-20 17:02

2 threads

Troubleshooting

Threads show individual messages instead of grouped

Thread grouping depends on the provider. IMAP accounts may not support threading. Gmail and Outlook thread natively.

Thread count seems low

Threads are paginated. Use --limit to increase the count, or use --json and pipe through `jq length` to check total.

Recommended guides

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