Turn inbound emails into structured JSON instantly

mailparse demo

Inbound Email

From: alice@acme.co

To: inbox-7f3a@mailparse.dev

Subject: Purchase Order #4091

Hi team,

Please find the signed PO attached.

Best, Alice

PO-4091.pdf (284 KB)

Parsed JSON

{
  "from": "alice@acme.co",
  "to": ["inbox-7f3a@mailparse.dev"],
  "subject": "Purchase Order #4091",
  "text": "Hi team,\nPlease find...",
  "html": "<p>Hi team,</p>...",
  "attachments": [
    {
      "filename": "PO-4091.pdf",
      "size": 290816,
      "contentType": "application/pdf",
      "url": "https://store.mailparse.dev/..."
    }
  ],
  "spf": "pass",
  "dkim": "pass"
}

Instant Addresses

Generate unique @mailparse.dev email addresses on demand. No DNS setup, no MX records.

Parsed to JSON

Headers, body, attachments - every part of the MIME envelope extracted and structured.

Webhook or Poll

Get parsed emails pushed to your endpoint in real-time, or fetch them when you need them.

Ship in Minutes

One API key, a few lines of code, and your app is receiving emails. No email server required.

What You Get

Everything you need to receive, parse, and process inbound email - without running your own mail server.

Full MIME Parsing

Every email is decomposed into its parts: plain text, HTML body, inline images, file attachments, headers, and routing info. No raw bytes to wrestle with.

Supports multipart/mixed, multipart/alternative, nested MIME, and encoded attachments out of the box.

Webhook Delivery

Each parsed email is POST-ed to your webhook URL as a JSON payload the moment it arrives. Retries with exponential backoff if your endpoint is down.

HMAC signature verification on every payload so you can trust the source.

REST Polling API

Not every workflow needs real-time. Query your inbox via REST to pull emails on your own schedule - perfect for batch processing and cron jobs.

Filter by sender, date range, subject, or attachment type. Paginated responses with cursor support.

Attachment Handling

Attachments are extracted, stored temporarily, and served via signed download URLs. No need to base64-decode anything yourself.

Files are available for 72 hours after receipt. Configurable retention per plan.

Developer Dashboard

Monitor inbound volume, inspect individual emails, replay failed webhooks, and manage API keys from a single interface.

Real-time logs, search by sender or subject, and one-click webhook replay.

Spam & Security Filtering

SPF, DKIM, and DMARC validation on every inbound email. Spam scoring built in so you only process the mail that matters.

Per-address rules to auto-reject, quarantine, or pass through based on sender reputation.

Three Steps to Structured Email

1

Create an Inbox

Generate a unique inbound email address from the dashboard or API. Use our domain or bring your own.

2

Receive Email

Send or forward emails to your address. MailParse receives them, validates SPF/DKIM, and parses the MIME.

3

Get JSON

Parsed email is delivered to your webhook as a POST, or you fetch it via our REST API. Headers, body, attachments - all structured.

Built for Developers

We replaced 200 lines of MIME parsing code with a single webhook endpoint. Took 15 minutes.

Backend Engineer

Support ticket automation

The polling API is great for our nightly batch job. We pull all emails since last run, process invoices, done.

Platform Developer

Invoice processing pipeline

SPF and DKIM validation out of the box means we can trust the parsed sender without writing our own checks.

Security Engineer

Email verification system

Start Free, Scale When Ready

A generous free tier for prototyping and testing. Upgrade when your volume grows.

Free

$0forever
  • 100 emails/month
  • Webhook delivery
  • REST polling API
  • 1 inbound address
  • Community support
Get Started

Pro

$29/month
  • 10,000 emails/month
  • Webhook + polling
  • Custom domains
  • 50 inbound addresses
  • Priority support
  • 72h attachment retention
Start Pro

Scale

$99/month
  • Unlimited emails
  • Webhook + polling
  • Unlimited domains
  • Unlimited addresses
  • Dedicated support
  • Custom retention
  • SLA guarantee
Contact Us

Frequently Asked Questions

How do I start receiving emails?

Sign up, grab an API key, and create an inbound address from the dashboard or via the API. Point your webhook URL or start polling - emails begin flowing immediately.

What does the parsed JSON look like?

Each email is returned as a JSON object with fields for from, to, cc, bcc, subject, text body, HTML body, headers, and an array of attachment objects with metadata and download URLs.

Can I use my own domain instead of @mailparse.dev?

Yes. Add an MX record pointing your domain to our servers, verify ownership in the dashboard, and all mail to that domain will be parsed and delivered to your webhook or polling endpoint.

What happens if my webhook endpoint is down?

We retry delivery with exponential backoff for up to 24 hours. You can also replay any email manually from the dashboard, or fall back to the polling API to retrieve missed messages.

How are attachments handled?

Attachments are extracted from the MIME body, stored securely, and exposed as signed download URLs in the JSON payload. Files are retained for 72 hours by default.

Is there a free tier?

Yes. The free plan includes a generous monthly email quota, webhook delivery, and REST polling access - enough to prototype and test your integration before scaling up.

How do you handle spam and security?

Every inbound email is validated against SPF, DKIM, and DMARC records. A spam score is included in the parsed output so you can filter programmatically.