Command

nylas webhook delete

Delete an existing webhook by ID.

Written by Qasim Muhammad Staff SRE

Published February 13, 2026Updated June 21, 2026

What does nylas webhook delete do?

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

Usage

nylas webhook delete <webhook-id> [--force]

Flags

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
--force(-f)	Skip confirmation prompt

Examples

The nylas webhook delete command removes a webhook destination from your Nylas application.

Delete a webhook by ID

nylas webhook delete wh_abc123def456 --force

List webhooks then delete one

nylas webhook list --json
nylas webhook delete wh_abc123def456

Example output

✓ Webhook deleted (webhook_abc123)
  Event notifications stopped for https://example.com/webhooks

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.

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