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

The nylas auth status command verifies whether the CLI is authenticated and the current token is valid. It checks API connectivity, token expiry, and grant health.

Quick Start

brew install nylas/nylas-cli/nylas
nylas init
nylas auth status

Syntax

nylas auth status

Examples

Check status:

nylas auth status

JSON for scripting:

nylas auth status --json

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

Status shows unauthenticated
Run nylas auth config --api-key to set your API key, or nylas auth login for OAuth.

Token valid but API calls fail
Your API key may lack the required scopes. Check your Nylas dashboard application settings.

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

All commands: Nylas CLI Command Reference

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