Command

nylas webhook delete

The nylas webhook delete command removes a webhook destination from your Nylas application. Pass the webhook ID with --id. The CLI confirms before deleting unless you pass --yes to skip the prompt. Deleted webhooks stop receiving event notifications immediately.

Written by Qasim Muhammad Staff SRE

What does nylas webhook delete do?

The nylas webhook delete command removes a webhook destination from your Nylas application. Pass the webhook ID with --id. The CLI confirms before deleting unless you pass --yes to skip the prompt. Deleted webhooks stop receiving event notifications immediately.

Usage

nylas webhook delete --id WEBHOOK_ID [--yes]

Flags

FlagDescription
--jsonOutput as JSON
--no-colorDisable color output
--verbose(-v)Enable verbose output
--configCustom config file path
--help(-h)Show help for the command
--limitLimit results (most list commands)
--yes(-y)Skip confirmations
--idWebhook ID to delete

Examples

Delete a webhook by ID

nylas webhook delete --id wh_abc123def456 --yes

List webhooks then delete one

nylas webhook list --json
nylas webhook delete --id wh_abc123def456

Troubleshooting

Webhook not found

Run nylas webhook list to see active webhooks. The ID may have already been deleted.

Permission denied

Webhook deletion requires a valid API key. Run nylas auth config to verify credentials.

Recommended guides

Send OTP and 2FA Codes by Email

Generate a cryptographically secure one-time code and send it by email from the terminal — no SMTP. Test the full round trip and learn email OTP's limits.

How to Evaluate an Email AI Agent

Evaluate an email agent with a labeled test set, classification and action-accuracy metrics, and prompt-injection guardrail tests you run on every change.

Gmail API Sandbox: Test Email Integrations

Gmail has no API sandbox. Compare the real options: a dedicated test account, the Amazon SES sandbox, fake SMTP inboxes, and nylas demo with sample data.

Password Reset Emails: Choosing an API

Password reset emails are latency-critical transactional sends. Compare SES, Postmark, SendGrid, and Nylas, meet Gmail's sender rules, and test the loop.

Mailtrap Alternative for Real Inbox Testing

Compare Mailtrap, Mailosaur, and Nylas Agent Accounts for testing transactional email flows with real inbox delivery.

Cypress Email Testing

Test password resets, magic links, and OTP emails in Cypress with a real inbox, Nylas CLI JSON output, and isolated agent accounts.

Test Email Webhooks Locally

Test Nylas email webhooks locally with tunnel setup, signed payload checks, trigger discovery, and replayable fixtures before shipping handlers.

Extract OTP Codes from Email — Skip the Inbox

Pull 2FA verification codes from email without opening your inbox. The nylas otp get command copies the latest code to your clipboard across all providers.

CI/CD Email Alerts with PowerShell

Send build failure alerts, deployment reports, and test results from GitHub Actions, Azure DevOps, and Jenkins pipelines using PowerShell and Nylas CLI.

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.

Run nylas webhook delete --help for full help output.