Command
nylas dashboard domains create
Register a domain for Nylas Inbox and Agent Accounts.
Written by Qasim Muhammad Staff SRE
What does nylas dashboard domains create do?
The nylas dashboard domains create command registers a domain in your active Dashboard organization. Use a free <subdomain>.nylas.email domain for Agent Account addresses, and pass --region us or --region eu to match the application region created during nylas init.
Usage
nylas dashboard domains create [domain] --region <region>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 |
| --domain | Domain address to register |
| --name(-n) | Display name (defaults to the domain) |
| --region(-r) | Region to register in (required: us or eu) |
Examples
The nylas dashboard domains create command registers a domain in your active Dashboard organization.
Register a US free domain
nylas dashboard domains create myagent.nylas.email --region usRegister an EU free domain
nylas dashboard domains create myagent.nylas.email --region euCreate an Agent Account on that domain
nylas agent account create user@myagent.nylas.emailExample output
✓ Domain registered (dom_abc123)
Address: example.com
Region: us
Status: pending
Next: run 'nylas dashboard domains dns dom_abc123' and add the DNS records.Troubleshooting
Region is required
Pass the same region as your active app. Use `nylas dashboard apps list` to confirm whether the app is in us or eu.
Domain is already registered
Run `nylas dashboard domains check <domain>` to see which region already owns it, then choose a different subdomain if needed.
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 create --help for full help output.