Source: https://cli.nylas.com/docs/commands/webhook-test-send

# nylas webhook test send

Send a test webhook event to a URL.

Written by [Qasim Muhammad](https://cli.nylas.com/authors/qasim-muhammad) Staff SRE

Published February 13, 2026

Updated June 21, 2026

## What does nylas webhook test send do?

The nylas webhook test send command fires a simulated webhook event to a URL you specify. Pass the destination URL as the positional argument. Use it to verify your endpoint is reachable and can handle a webhook request before going live.

## Usage

```bash
nylas webhook test send <webhook-url>
```

## 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 |

## Examples

The nylas webhook test send command fires a simulated webhook event to a URL you specify.

### Send a test event to a public endpoint

```bash
nylas webhook test send https://example.com/webhook
```

### Send to a local tunnel

```bash
nylas webhook test send https://example-tunnel.trycloudflare.com/webhook
```

## Example output

```text
Sending test event to https://example.com/webhooks ...
✓ Endpoint responded 200 OK (142ms)
  Test payload delivered successfully.
```

## Troubleshooting

### Connection refused

Verify the URL is reachable. For localhost URLs, ensure your server is running on the correct port.

### Need a specific trigger payload

Use nylas webhook test payload <trigger> to generate a deterministic payload for a specific trigger type.

## Related commands

[nylas webhook createCreate a webhook for real-time event notifications.](https://cli.nylas.com/docs/commands/webhook-create)

[nylas webhook deleteDelete an existing webhook by ID.](https://cli.nylas.com/docs/commands/webhook-delete)

[nylas webhook listList all webhooks.](https://cli.nylas.com/docs/commands/webhook-list)

[nylas webhook pubsub createCreate a Pub/Sub channel](https://cli.nylas.com/docs/commands/webhook-pubsub-create)

[nylas webhook pubsub deleteDelete a Pub/Sub channel](https://cli.nylas.com/docs/commands/webhook-pubsub-delete)

[nylas webhook pubsub listList Pub/Sub channels](https://cli.nylas.com/docs/commands/webhook-pubsub-list)

## Recommended guides

[Send OTP and 2FA Codes by EmailGenerate 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.](https://cli.nylas.com/guides/send-otp-email-cli)

[How to Evaluate an Email AI AgentEvaluate an email agent with a labeled test set, classification and action-accuracy metrics, and prompt-injection guardrail tests you run on every change.](https://cli.nylas.com/guides/evaluate-email-agents)

[Gmail API Sandbox: Test Email IntegrationsGmail 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.](https://cli.nylas.com/guides/email-api-sandbox-testing)

[Password Reset Emails: Choosing an APIPassword reset emails are latency-critical transactional sends. Compare SES, Postmark, SendGrid, and Nylas, meet Gmail's sender rules, and test the loop.](https://cli.nylas.com/guides/password-reset-email-api)

[Mailtrap Alternative for Real Inbox TestingCompare Mailtrap, Mailosaur, and Nylas Agent Accounts for testing transactional email flows with real inbox delivery.](https://cli.nylas.com/guides/mailtrap-alternative-real-inbox-testing)

[Cypress Email TestingTest password resets, magic links, and OTP emails in Cypress with a real inbox, Nylas CLI JSON output, and isolated agent accounts.](https://cli.nylas.com/guides/cypress-email-testing)

Run `nylas webhook test send --help` for full help output.