Command
nylas dashboard domains list
List registered email domains in the active Dashboard organization.
Written by Qasim Muhammad Staff SRE
What does nylas dashboard domains list do?
The nylas dashboard domains list command displays email domains registered in your active Dashboard organization, including each domain ID, region, and verification status. Use it before creating Agent Accounts so you know which *.nylas.email subdomains or custom domains are ready for managed addresses.
Usage
nylas dashboard domains list [flags]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 domains to return (default: 100) |
| --yes(-y) | Skip confirmations |
| --page-token | Page token for pagination |
Examples
The nylas dashboard domains list command displays email domains registered in your active Dashboard organization, including each domain ID, region, and verification status.
List domains
nylas dashboard domains listList as JSON
nylas dashboard domains list --jsonExample output
DOMAIN ID ADDRESS REGION STATUS
dom_abc123 example.com us verified
dom_def456 mail.example.com eu pending
2 domainsTroubleshooting
No domains are shown
Register a free subdomain with `nylas dashboard domains create <subdomain>.nylas.email --region us` or add a custom domain from the Dashboard.
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.
Automate Customer Onboarding Emails
Run a multi-day onboarding sequence from a signup hook with nylas email send --schedule and hosted templates — no marketing platform, no SMTP.
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 dashboard domains list --help for full help output.