# email-webhook

> Receive inbound email as a structured JSON webhook — skip the IMAP
> polling loops and MIME parsing, and treat every message as an event.

## Docs

- [Introduction](https://email-webhook.com/docs/introduction.md): Learn how to receive incoming email as JSON in your server with email-webhook — no IMAP polling, no MIME parsing, and no infrastructure to manage.
- [What is an Email Webhook?](https://email-webhook.com/docs/what-is-an-email-webhook.md): An email webhook turns incoming mail into an HTTP request your server handles in real time — no polling loop, no IMAP, no MIME parsing.
- [Getting Started](https://email-webhook.com/docs/getting-started.md): Forward your first email to a webhook in five minutes — from sign-up to a live JSON delivery.
- [Choosing an HTTP Method](https://email-webhook.com/docs/http-methods.md): POST, PUT, PATCH, DELETE, and GET all work — here is how each method affects where the email data lands and which one to use.
- [Authenticating Your Endpoint](https://email-webhook.com/docs/authentication.md): Keep your webhook endpoint secure with a secret email address, custom authentication headers, and HMAC-SHA256 request signing.
- [Debugging with Message Logs](https://email-webhook.com/docs/message-logs.md): Message Logs show per-delivery HTTP status, duration, and sender metadata so you can debug failed webhook calls without storing email content.
- [Handling Attachments](https://email-webhook.com/docs/handling-attachments.md): Email attachments arrive as inline base64 strings in the JSON payload. Learn how to decode and save them in Node.js, Python, and Go, and when to stream large files to cloud storage.
- [Privacy and Data Retention](https://email-webhook.com/docs/privacy-and-data.md): email-webhook is a pass-through, not an archive — email bodies and attachments are never written to disk.

## Guides

- [AI and LLM Pipelines](https://email-webhook.com/guides/ai-llm-pipelines.md): Wire an incoming email straight into an LLM — email-webhook delivers the parsed message as JSON so your server can focus on the AI logic.
- [AWS Lambda with SST](https://email-webhook.com/guides/aws-lambda-sst.md): Build a serverless email webhook handler in minutes using SST v3, API Gateway v2, and TypeScript. Deploy to AWS and wire it up to email-webhook.
- [Email Webhook vs. SendGrid Inbound Parse](https://email-webhook.com/guides/email-webhook-vs-sendgrid-inbound-parse.md): Compare email-webhook and SendGrid Inbound Parse — setup complexity, payload format, privacy model, and which to choose for your use case.
- [Email Webhook vs. Postmark Inbound](https://email-webhook.com/guides/email-webhook-vs-postmark-inbound.md): Compare email-webhook and Postmark Inbound — JSON payloads, authentication models, setup steps, privacy, and which service fits your use case.
- [Email Webhook vs. IMAP Polling](https://email-webhook.com/guides/email-webhook-vs-imap-polling.md): Compare email webhooks against IMAP polling — delivery model, latency, infrastructure cost, and when to choose each approach.