Command
nylas webhook create
The nylas webhook create command registers a URL to receive real-time notifications when email, calendar, or contact events occur. Specify trigger types like message.created, event.updated, or contact.deleted. Webhooks fire within seconds of the event, replacing polling-based sync. Real-time delivery for agent account inboxes also runs through this command — replaces the deprecated nylas inbound monitor.
Usage
nylas webhook create --url URL --triggers TRIGGERSFlags
| 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 |
| --url | Webhook URL |
| --triggers | Comma-separated trigger types |
Examples
Create webhook
nylas webhook create --url https://yourserver.com/webhook --triggers "message.created,event.updated"Subscribe to inbound mail for an agent account
nylas webhook create --url https://example.com/hook --triggers message.createdTroubleshooting
Migrating from nylas inbound monitor
Use nylas webhook create --triggers message.created to subscribe to real-time inbound events. There is no agent equivalent of the streaming-to-terminal mode; expose a local tunnel (cloudflared, ngrok) and point --url at it for development.
Recommended guides
Stop Your AI Agent From Going Rogue
Set inbound and outbound guardrails on AI agent email. Block phishing senders, archive replies, and contain prompt-injection escalation at the connector layer.
Install Nylas Skills for AI Coding Agents
Install nylas-cli and nylas-api skills in Claude Code, Cursor, Codex CLI, Windsurf, and 30+ AI coding agents with one command.
Create an AI Agent Email Identity
Set up a managed email identity for an AI agent. Send and receive from a real inbox in 2 minutes — no OAuth, no third-party mailbox.
Build an AI Email Triage Agent
Build an AI agent that reads your inbox, classifies emails by urgency, drafts replies, and archives noise. Python + Nylas CLI + any LLM.
Receive Email Without an SMTP Server
Create a managed agent email account and process incoming messages via webhooks — no Postfix, no MX records. Uses the nylas agent surface (replaces the deprecated nylas inbound).
Extract OTP Codes from Email — Skip the Inbox
Pull 2FA verification codes from email without opening your inbox. nylas otp get copies the code to your clipboard. Works with Gmail, Outlook, Exchange, Yahoo, iCloud, and IMAP.
Give Your AI Coding Agent an Email Address
Connect Claude Code, Cursor, OpenAI Codex CLI, Windsurf, and OpenClaw to a real email account via MCP. Step-by-step setup for each tool using Nylas CLI.
Send Email from Linux/Manus Sandbox Without SMTP
Send email from a Linux or Manus sandbox over HTTPS when SMTP ports 25, 465, and 587 are blocked. No Postfix or sendmail — Nylas CLI handles delivery.
Manus AI Email Research Agent
Use Manus AI to deep-search your inbox, summarize email threads, extract decisions, and compile research — all powered by Nylas CLI email commands.
Build an Email Support Agent with Manus AI
Build a Manus support agent that polls a support inbox, matches knowledge base articles, drafts replies, and routes risky tickets for human approval.
Reach Inbox Zero with Manus AI
Reach inbox zero with Manus AI. Triage unread email, categorize by urgency, draft replies, and archive — all via natural language and Nylas CLI.
Mail Manus: Automate Email from CLI
Compare Mail Manus forwarding with direct inbox access. Learn when to add the Nylas CLI Skill for search, sending, follow-ups, and calendar workflows.
CI/CD Email Alerts with PowerShell
Send build notifications, deployment reports, and test failure alerts from GitHub Actions, Azure DevOps, and Jenkins using PowerShell and Nylas CLI.
Create a Manus Skill: Email & Calendar Workflow
Create a Manus Skill that installs Nylas CLI in the sandbox and teaches your agent email and calendar workflows via SKILL.md and setup scripts.
E2E Email Testing with Playwright
Test password reset, invitation, and verification emails end-to-end. Poll with Nylas CLI, verify content in Playwright, and click links. No Gmail config needed.
Build an LLM Agent with Email & Calendar Tools
Add email and calendar tools to your LLM agent using Nylas CLI subprocess commands. List messages, send email, and create events without writing API clients.
Run nylas webhook create --help for full help output.