Using nylas auth migrate to migrate from v2 to v3

Every email, calendar, and contact operation requires auth. nylas auth migrate manages that layer.

The nylas auth migrate command upgrades your CLI authentication from Nylas API v2 to v3. It converts stored credentials and grant formats so existing scripts and automation continue working after the migration.

Examples

Run migration:

nylas auth migrate

Check migration status after:

nylas auth migrate && nylas auth status

Syntax

nylas auth migrate

How It Works

The CLI stores credentials securely in your system keychain (macOS Keychain, Linux Secret Service, or Windows Credential Manager). Tokens are refreshed automatically — you authenticate once and commands just work.

Common Issues

No v2 credentials found
This means you're already on v3, or no accounts were connected under v2. No action needed.

Migration fails with permission error
Check that your API key has v3 access. Contact Nylas support if your account hasn't been upgraded.

---

Full docs: nylas auth migrate reference — all flags, advanced examples, and troubleshooting.

All commands: Nylas CLI Command Reference

Get started: brew install nylas/nylas-cli/nylas — other install methods