Source: https://cli.nylas.com/docs/commands/deliverability-send-events-summary # nylas deliverability send-events summary Show send health, totals, and rates. Written by [Qasim Muhammad](https://cli.nylas.com/authors/qasim-muhammad) Staff SRE Published November 3, 2026 Updated November 3, 2026 ## What does nylas deliverability send-events summary do? The nylas deliverability send-events summary command reports send health, totals, and delivery, bounce, and complaint rates with the change against the prior period. 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. Health always grades the last 7 days and lists findings when a domain is at risk or critical. ## Usage ```bash nylas deliverability send-events summary [--start YYYY-MM-DD] [--end YYYY-MM-DD] [--sending-domain DOMAIN] [--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 | | --end | Last UTC day, YYYY-MM-DD, inclusive (default: today) | | --sending-domain | Only this sending domain | | --start | First UTC day, YYYY-MM-DD (default: 6 days before --end) | ## Examples The nylas deliverability send-events summary command reports send health, totals, and delivery, bounce, and complaint rates with the change against the prior period. ### Last 7 days ```bash nylas deliverability send-events summary ``` ### One month for one sending domain ```bash nylas deliverability send-events summary --start 2026-10-01 --end 2026-10-31 --sending-domain mail.example.com ``` ## Example output ```text Health: healthy (last 7 days, 2026-10-27 → 2026-11-02) Prior period: 2026-10-20 → 2026-10-26 SENT DELIVERED HARD BOUNCES SOFT BOUNCES UNDETERMINED REJECTED COMPLAINTS 1200 1180 12 5 0 0 1 RATE VALUE CHANGE PRIOR STATUS delivery 98.33% +0.40 pp 97.93% ok bounce (hard) 1.00% -0.20 pp 1.20% ok complaint 0.08% — — ok ``` ## Troubleshooting ### invalid --start value on a metrics command Metrics windows take UTC dates in YYYY-MM-DD form, both days included, and can span at most 365 days. Unix timestamps and look-backs are for the activity list commands only. ### A rate shows a dash instead of 0% A dash means the rate has no denominator in the window (for example no sends), so there is no data. It is not a 0% rate. ### Health is insufficient_data Health is graded only when the last 7 days have at least 100 sends. Totals and rates for your window still show. ## Related commands [nylas deliverability send-alerts createCreate a send alert rule.](https://cli.nylas.com/docs/commands/deliverability-send-alerts-create) [nylas deliverability send-alerts deleteDelete a send alert rule.](https://cli.nylas.com/docs/commands/deliverability-send-alerts-delete) [nylas deliverability send-alerts listList send alert rules.](https://cli.nylas.com/docs/commands/deliverability-send-alerts-list) [nylas deliverability send-alerts showShow a send alert rule.](https://cli.nylas.com/docs/commands/deliverability-send-alerts-show) [nylas deliverability send-alerts updateChange a send alert rule; flags you leave out keep their value.](https://cli.nylas.com/docs/commands/deliverability-send-alerts-update) [nylas deliverability send-events breakdownShow send counts and rates per sending domain, agent account, or recipient domain.](https://cli.nylas.com/docs/commands/deliverability-send-events-breakdown) ## Recommended guides [Track Email Opens, Clicks, and RepliesSend tracked email and receive open, click, and reply events over webhooks from the terminal. Verify the signatures, and learn why email open rates overcount.](https://cli.nylas.com/guides/track-email-opens-replies-cli) [SMTP Reply Codes ExplainedDecode SMTP reply codes: 2xx success, 4xx transient retry, 5xx permanent. Read bounce DSN enhanced codes and debug delivery from the terminal.](https://cli.nylas.com/guides/smtp-reply-codes-explained) [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.](https://cli.nylas.com/guides/email-bounce-codes-reference) [Validate Email Addresses from the CLIValidate 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.](https://cli.nylas.com/guides/email-address-validation-cli) [AI Agent Email Bounce Detection and RetryDeterministic 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.](https://cli.nylas.com/guides/ai-agent-email-bounce-retry) [Soft Bounce vs Hard Bounce ExplainedSoft 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.](https://cli.nylas.com/guides/soft-bounce-vs-hard-bounce) Run `nylas deliverability send-events summary --help` for full help output.