| name | sendgrid-inbound |
| description | Receive inbound emails via SendGrid Inbound Parse Webhook. Covers MX record setup, webhook configuration, payload parsing, attachment handling, and security best practices. Use when receiving emails programmatically, parsing email content, handling email replies, or building email-to-app workflows. Triggers on receive email, inbound email, email webhook, parse email, email to app, MX record, Inbound Parse. |
Receive Emails with SendGrid (Inbound Parse)
Overview
SendGrid's Inbound Parse Webhook receives emails for a specific hostname/subdomain, parses the message, and POSTs it to your webhook as multipart/form-data.
Key differences vs Resend:
- SendGrid posts the full parsed email (text/html/headers/attachments) directly to your webhook.
- There is no official signature verification for Inbound Parse (unlike SendGrid Event Webhook). You must secure the endpoint yourself.
Quick Start
Verify Your Setup First
../scripts/verify-inbound-setup.sh parse.example.com https://webhook.example.com/parse
Then configure:
- Create MX record pointing to
mx.sendgrid.net for a dedicated hostname (recommended: subdomain).
- Configure Inbound Parse in SendGrid Console with a receiving domain + destination URL.
- Handle the webhook: parse
multipart/form-data, read text, html, headers, and attachments.
- Secure the endpoint (basic auth, allowlists, size limits).
Parse Webhook Payloads
