Command
nylas inbound messages
The nylas inbound messages command lists messages received by a managed inbound inbox. Filter by unread status and limit results for efficient polling. Designed for E2E test suites that send email and need to verify delivery — poll with --unread --json and pipe into assertions.
Usage
nylas inbound messages <inbox-id> [options]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 | Limit results (most list commands) |
| --yes(-y) | Skip confirmations |
| --unread | Only unread messages |
Examples
List messages
nylas inbound messages inbox_abc123 --json --limit 20Unread only
nylas inbound messages inbox_abc123 --unread --jsonTroubleshooting
Wrong inbox ID
Use nylas inbound list to get IDs. Set NYLAS_INBOUND_GRANT_ID for default.
Recommended guides
Receive Email Without an SMTP Server
Create a managed email address and process incoming messages via webhooks — no Postfix, no MX records. nylas inbound works with Gmail, Outlook, Exchange, Yahoo, iCloud, and IMAP.
Extract OTP Codes from Email — Skip the Inbox
Pull 2FA verification codes from email without opening your inbox. nylas otp get copies the code to your clipboard. Works with Gmail, Outlook, Exchange, Yahoo, iCloud, and IMAP.
CI/CD Email Alerts with PowerShell
Send build notifications, deployment reports, and test failure alerts from GitHub Actions, Azure DevOps, and Jenkins using PowerShell and Nylas CLI.
E2E Email Testing with Playwright
Test password reset, invitation, and verification emails end-to-end. Poll with Nylas CLI, verify content in Playwright, and click links. No Gmail config needed.
Run nylas inbound messages --help for full help output.