sendgrid-inbound

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

# Check MX record and test webhook
../scripts/verify-inbound-setup.sh parse.example.com https://webhook.example.com/parse

Then configure:

1. Create MX record pointing to mx.sendgrid.net for a dedicated hostname (recommended: subdomain).
2. Configure Inbound Parse in SendGrid Console with a receiving domain + destination URL.
3. Handle the webhook: parse multipart/form-data, read text, html, headers, and attachments.
4. Secure the endpoint (basic auth, allowlists, size limits).

Parse Webhook Payloads