Manage Nylas Applications, Connectors, and Grants from the CLI

#cli #devops #api #tutorial

The nylas admin commands let you manage your Nylas infrastructure without the web dashboard. Create applications, configure provider connectors, manage OAuth credentials, and monitor grants — all from the terminal.

What nylas admin does

Full API management surface: applications, callback URIs, provider connectors (Google, Microsoft, IMAP), credentials, and grants. Useful for CI/CD pipelines, multi-tenant setups, and infrastructure-as-code workflows.

Quick Start

brew install nylas/nylas-cli/nylas
nylas init
nylas admin applications list

Key commands

Command	What it does
`nylas admin applications list`	List all applications
`nylas admin applications create`	Create a new application
`nylas admin connectors list`	List provider connectors
`nylas admin connectors create`	Create a Google/Microsoft/IMAP connector
`nylas admin credentials list <connector-id>`	List credentials for a connector
`nylas admin credentials create`	Add OAuth credentials
`nylas admin callback-uris list`	List OAuth callback URIs
`nylas admin callback-uris create --url <url>`	Register a new callback URI
`nylas admin grants list`	List all grants on the application
`nylas admin grants stats`	Show grant statistics

Creating an application and connector

# Create app
nylas admin applications create --name "prod-email" --json

# Add Google connector
nylas admin connectors create \
  --provider google \
  --client-id $GOOGLE_CLIENT_ID \
  --client-secret $GOOGLE_CLIENT_SECRET

# Register callback URI
nylas admin callback-uris create --url https://myapp.com/oauth/callback

Monitoring grants

# How many users are connected?
nylas admin grants stats --json

# List all grants with their status
nylas admin grants list --json | jq '.[] | {id, provider, status}'