Command

nylas webhook update

Update an existing webhook's URL or triggers.

Written by Qasim Muhammad Staff SRE

Published February 13, 2026Updated June 21, 2026

What does nylas webhook update do?

The nylas webhook update command modifies a webhook destination. Change the delivery URL with --url, or add and remove trigger types with --triggers. Pass the webhook ID as a positional argument. Changes take effect immediately — the next event fires to the updated URL.

Usage

nylas webhook update <webhook-id> [--url URL] [--triggers TRIGGERS]

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
--url	New destination URL
--triggers	Comma-separated trigger types to subscribe to
--description(-d)	New description
--notify(-n)	New notification email addresses
--status(-s)	New status (active or inactive)

Examples

The nylas webhook update command modifies a webhook destination.

Change the webhook URL

nylas webhook update wh_abc123def456 --url https://new-endpoint.example.com/webhook

Add a trigger type

nylas webhook update wh_abc123def456 --triggers message.created,event.created,event.updated

Example output

✓ Webhook updated (webhook_abc123)
  URL:      https://example.com/webhooks
  Triggers: message.created, message.updated
  Status:   inactive

Troubleshooting

Webhook not found

Run nylas webhook list to confirm the webhook ID. It may have been deleted.

Invalid trigger type

Run nylas webhook triggers to see valid types. Trigger names are case-sensitive.

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 update --help for full help output.