Command
nylas email metadata show
Show full email metadata — headers, message IDs, and provider-specific fields.
Written by Qasim Muhammad Staff SRE
What does nylas email metadata show do?
The nylas email metadata show command displays the raw headers and internal metadata for a message, including Message-ID, In-Reply-To, References, and provider-specific IDs. Useful for debugging delivery issues or threading problems.
Usage
nylas email metadata show <message-id> [grant-id]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 email metadata show command displays the raw headers and internal metadata for a message, including Message-ID, In-Reply-To, References, and provider-specific IDs.
Show metadata for an email
nylas email metadata show msg_abc123Extract the Message-ID header
nylas email metadata show msg_abc123 --json | jq -r '.headers["Message-ID"]'Example output
Metadata for msg_abc123
key1: campaign=q4
key2: type=invoice
customer: acme-corpTroubleshooting
Headers appear empty or incomplete
Some providers only return a subset of headers. Try --json for the full response including provider-specific fields.
Message-ID differs from provider's webmail
Nylas normalizes Message-IDs. The raw RFC822 Message-ID is in the headers object; the top-level id is the Nylas internal ID.
Recommended guides
List Fastmail emails from the CLI
List Fastmail emails from the CLI through Nylas IMAP access, using app passwords, inbox filters, JSON output, and Fastmail-specific auth troubleshooting.
Why Cloud Servers Block SMTP Ports
AWS, GCP, and Azure block outbound SMTP port 25 while ports 587 and 465 stay open. Confirm the block and send email over an HTTPS API instead.
Send Email From a Docker Container
Cloud providers block SMTP port 25 from containers. Send email over an HTTPS API on port 443 with one command and no mail daemon at all.
MailerSend vs Nylas: Email Compared
MailerSend sends transactional email from verified domains. Nylas reads and syncs user inboxes across 6 providers. Compare features, pricing, and use cases.
Customer.io vs Nylas: Email Compared
Customer.io sends lifecycle emails to your user base. Nylas reads and sends from real user inboxes via OAuth. Compare use cases, pricing, and AI agent support.
Knock vs Nylas: Notifications vs Email API
Knock delivers multi-channel product notifications via workflows; Nylas provides two-way email and calendar sync. Compare scope, pricing, and agent support.
Run nylas email metadata show --help for full help output.