Command
nylas deliverability send-alerts list
List send alert rules.
Written by Qasim Muhammad Staff SRE
What does nylas deliverability send-alerts list do?
The nylas deliverability send-alerts list command shows your send alert rules: the metric, direction, threshold, window, and minimum volume. It covers only messages sent from an Agent Account or through Transactional send; messages from connected grants such as Google or Microsoft accounts are not included. When a rule fires for a sending domain, Nylas sends the alert.triggered webhook to your webhook subscriptions.
Usage
nylas deliverability send-alerts list [--json]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 deliverability send-alerts list command shows your send alert rules: the metric, direction, threshold, window, and minimum volume.
List rules
nylas deliverability send-alerts listList rule IDs only
nylas deliverability send-alerts list --quietExample output
ID FIRES WHEN WINDOW MIN VOLUME UPDATED
3d6f8a1c-2b4e-4c7d-9f0a-1b2c3d4e5f60 bounce_rate above 5% 1h 50 2026-10-23 15:53:55 UTC
8069c06e-a4c0-4bfa-9535-0f286575cc0e delivery_rate below 95% 24h 0 2026-10-23 16:45:26 UTCTroubleshooting
403 api.forbidden: this endpoint requires an application API key
These commands are application-level. Configure an API key with nylas auth config or NYLAS_API_KEY; a grant access token is rejected.
Recommended guides
Track Email Opens, Clicks, and Replies
Send tracked email and receive open, click, and reply events over webhooks from the terminal. Verify the signatures, and learn why email open rates overcount.
SMTP Reply Codes Explained
Decode SMTP reply codes: 2xx success, 4xx transient retry, 5xx permanent. Read bounce DSN enhanced codes and debug delivery from the terminal.
Email Bounce Codes Reference (DSN)
Decode bounce DSNs: RFC 3463 enhanced status codes (5.1.1, 5.2.2, 4.x.x), hard vs soft bounces, and finding them with nylas email search from:mailer-daemon.
Validate Email Addresses from the CLI
Validate email addresses from the terminal with an RFC 5322 syntax check and a dig MX lookup, then gate nylas email send to cut hard bounces.
AI Agent Email Bounce Detection and Retry
Deterministic bounce rules for AI agents: classify soft vs hard from DSN codes, retry 4.x.x with backoff, suppress 5.x.x, and escalate edge cases to humans.
Soft Bounce vs Hard Bounce Explained
Soft bounces (4xx) are transient and retried for up to 5 days; hard bounces (5xx) are permanent. Code ranges, suppression rules, and terminal detection with the CLI.
Run nylas deliverability send-alerts list --help for full help output.