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

# nylas webhook test send

The nylas webhook test send-URL command fires a simulated webhook event to any URL you specify. Choose the trigger type with --trigger (e.g. message.created, event.created). Use it to verify your endpoint handles payloads correctly before going live.

## Usage

```bash
nylas webhook test send-URL --url URL --trigger TRIGGER
```

## 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 | Destination URL to send the test event to |
| --trigger | Trigger type (e.g. message.created, event.created) |

## Examples

### Test with an email trigger

```bash
nylas webhook test send-URL --url https://example.com/webhook --trigger message.created
```

### Test with a calendar trigger

```bash
nylas webhook test send-URL --url http://localhost:4567/webhook --trigger event.created
```

## Troubleshooting

### Connection refused

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

### Unknown trigger type

Run nylas webhook triggers to see all available trigger types.

## Recommended guides

[Extract OTP Codes from Email — Skip the InboxPull 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.](https://cli.nylas.com/guides/extract-otp-codes-from-email)

[CI/CD Email Alerts with PowerShellSend build notifications, deployment reports, and test failure alerts from GitHub Actions, Azure DevOps, and Jenkins using PowerShell and Nylas CLI.](https://cli.nylas.com/guides/powershell-email-cicd)

[E2E Email Testing with PlaywrightTest password reset, invitation, and verification emails end-to-end. Poll with Nylas CLI, verify content in Playwright, and click links. No Gmail config needed.](https://cli.nylas.com/guides/e2e-email-testing)

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