Command
nylas deliverability send-events show
Show one send event with its provider detail.
Written by Qasim Muhammad Staff SRE
What does nylas deliverability send-events show do?
The nylas deliverability send-events show command prints one send event with its provider detail: the SMTP response, diagnostic code, bounce type and subtype, reporting MTA, and processing time. 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. Use it to see exactly why a recipient bounced or complained.
Usage
nylas deliverability send-events show <event-id> [--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-events show command prints one send event with its provider detail: the SMTP response, diagnostic code, bounce type and subtype, reporting MTA, and processing time.
Show one event
nylas deliverability send-events show 5f2c7a4e9b1d3c8f0a6e2d4b7c9f1a3e5d7b9c2f4a6e8d0b1c3f5a7e9d2b4c6fShow one event as JSON
nylas deliverability send-events show 5f2c7a4e9b1d3c8f0a6e2d4b7c9f1a3e5d7b9c2f4a6e8d0b1c3f5a7e9d2b4c6f --jsonExample output
Event ID: 5f2c7a4e9b1d3c8f0a6e2d4b7c9f1a3e5d7b9c2f4a6e8d0b1c3f5a7e9d2b4c6f
Event: bounced (hard)
Time: 2026-10-29 16:13:20 UTC
Message ID: <abc@mail.example.com>
From: agent@mail.example.com
Recipient: bob@example.net
Reason: General (5.1.1)
Diagnostic: smtp; 550 5.1.1 user unknown
Bounce type: Permanent GeneralTroubleshooting
invalid event ID
Event IDs are 64 lowercase hex characters. Copy one from the EVENT ID column of the list command, or the id field of list --json.
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.
no send activity found in the last 90 days
The event is older than the 90-day activity retention, or it belongs to another application.
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-events show --help for full help output.