Command
nylas agent account list
List all Nylas agent accounts.
Written by Qasim Muhammad Staff SRE
What does nylas agent account list do?
The nylas agent account list command displays every managed agent email identity (provider=nylas) provisioned on the active application. Each entry shows the email address, account ID, and status. Agent accounts replace the deprecated nylas inbound surface and are used for E2E testing, transactional receive, and giving an AI agent its own inbox without OAuth.
Usage
nylas agent account listFlags
| 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 |
Examples
List agent accounts
nylas agent account listJSON output
nylas agent account list --jsonExample output
EMAIL GRANT ID NAME
support@yourapp.nylas.email agent_abc123 Support Bot
me@yourapp.nylas.email agent_def456 Inbox Agent
2 agent accountsTroubleshooting
No agent accounts shown
Create one with nylas agent account create <email>. Run nylas agent status to confirm the nylas connector is available on this application.
Migrating from nylas inbound
nylas inbound is deprecated. nylas agent account list is the direct replacement; existing inbound inboxes appear as agent accounts.
Recommended guides
Build a Mastra Email Agent
Give a Mastra TypeScript agent email by wrapping the Nylas CLI as a createTool — one subprocess call, JSON in and out, across Gmail, Outlook, and more.
Add Email Sync to Your App Without IMAP
Skip per-mailbox IMAP IDLE connections. Use webhooks for push and on-demand reads for backfill, prototyped from the terminal — and know when IMAP still wins.
Send OTP and 2FA Codes by Email
Generate a cryptographically secure one-time code and send it by email from the terminal — no SMTP. Test the full round trip and learn email OTP's limits.
Build a Transactional Email Agent
Send receipts, confirmations, and alerts from a dedicated agent account — DKIM-signed, idempotent, and rate-capped by a workspace policy, no SMTP relay.
Trigger Agents on Inbound Email with Webhooks
Replace cron polling with webhooks: register a message.created hook so your agent account wakes the agent the instant mail arrives, signature-verified.
Build an Email Digest Agent
Send an opt-in digest to a subscriber group from an agent account — resolve the recipient list from contacts, honor unsubscribes, and send on a schedule.
Run nylas agent account list --help for full help output.