Command
nylas deliverability tracking-events message
Show open and click totals and the newest 100 interactions for one message.
Written by Qasim Muhammad Staff SRE
What does nylas deliverability tracking-events message do?
The nylas deliverability tracking-events message command shows open and click totals for one message, clicks per link, and the newest 100 interactions. 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. Only messages sent with open or link tracking turned on have tracking events. Totals count every interaction, not only the 100 shown.
Usage
nylas deliverability tracking-events message <message-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 tracking-events message command shows open and click totals for one message, clicks per link, and the newest 100 interactions.
Opens and clicks for one message
nylas deliverability tracking-events message "<abc@mail.example.com>"Troubleshooting
Message ID with angle brackets fails or matches nothing
For a Transactional send the message ID is the Message-ID header, angle brackets included. Quote it in the shell, for example "<abc@mail.example.com>". The CLI percent-encodes it for the API.
No tracking events for a message
Tracking events exist only when the message was sent from an Agent Account or through Transactional send with open or link tracking turned on. Messages from connected Google or Microsoft grants are not included.
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 tracking-events message --help for full help output.