Email Parsing API
That Actually Works

Stop wrestling with raw email headers and MIME parsing. Get clean, structured email data from any email with our professional parsing API. Built for developers who value their time.

No credit card required • 1,000 emails/month free • Parse immediately

Complete Email Data Extraction

badge 13

Headers & Metadata

Message-ID, In-Reply-To, References, Date, and all custom headers extracted and structured.

• Message threading data
• Custom headers
• Routing information
badge 13

Content Parsing

Separate plain text and HTML content with proper encoding and structure preservation.

• Plain text body
• HTML body
• Encoding detection
badge 13

Address Parsing

From, To, CC, BCC, and Reply-To addresses parsed with names and email addresses separated.

• Name extraction
• Email validation
• Multiple recipients
badge 13

Attachment Processing

Automatic attachment extraction with filename, content type, and size detection.

• Binary data handling
• MIME type detection
• Size validation
badge 13

Security Analysis

SPF, DKIM, DMARC validation plus spam filtering and malware detection built-in.

• Auth verification
• Spam detection
• Malware scanning
badge 13

Thread Analysis

Intelligent conversation threading with reply chain reconstruction and context preservation.

• Reply chain tracking
• Conversation grouping
• Context preservation

Simple Email Parsing API

Send raw email content to our parsing API and get back clean, structured data. Perfect for processing stored emails or custom integrations.

API Request

POST https://api.inbound.new/v2/parse
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "rawEmail": "From: sender@example.com\n
To: recipient@yourapp.com\n
Subject: Test email\n
Content-Type: text/plain\n\n
Hello, this is a test email with
an attachment."
}

Parsed Response

{
  "success": true,
  "parsedData": {
    "messageId": "<abc123@example.com>",
    "date": "2024-01-15T10:30:00Z",
    "from": {
      "address": "sender@example.com",
      "name": "John Doe"
    },
    "to": [
      {"address": "recipient@yourapp.com"}
    ],
    "subject": "Test email",
    "textBody": "Hello, this is a test...",
    "htmlBody": null,
    "attachments": [
      {
        "filename": "document.pdf",
        "contentType": "application/pdf",
        "size": 12345,
        "url": "https://storage.inbound.new/..."
      }
    ],
    "headers": {
      "X-Custom-Header": "value"
    }
  }
}

Advanced Email Parsing Capabilities

badge 13

MIME Parsing

Handle complex multipart emails, nested MIME structures, and mixed content types automatically.

badge 13Multipart/mixed parsing
badge 13Nested MIME handling
badge 13Encoding detection
badge 13

Header Analysis

Extract and parse all email headers including authentication, routing, and custom headers.

badge 13Authentication headers
badge 13Routing information
badge 13Custom header extraction
badge 13

Content Extraction

Separate plain text and HTML content with smart encoding handling and structure preservation.

badge 13Plain text extraction
badge 13HTML content parsing
badge 13Encoding normalization
badge 13

Attachment Processing

Extract, decode, and store attachments with metadata including filename, size, and content type.

badge 13Binary data handling
badge 13MIME type detection
badge 13Secure storage URLs

TypeScript SDK for Email Parsing

Get full type safety and IntelliSense support with our TypeScript SDK. Makes email parsing development fast and error-free.

TypeScript Email Parsing Example

import { createInboundClient } from '@inboundemail/sdk'

const inbound = createInboundClient({
  apiKey: process.env.INBOUND_API_KEY
})

// Parse email from raw source
const result = await inbound.emails.parse({
  rawEmail: emailSource
})

// Fully typed response with IntelliSense
const parsedEmail = result.parsedData

// Access data with full type safety
console.log('From Name:', parsedEmail.from.name)
console.log('From Email:', parsedEmail.from.address)
console.log('Subject:', parsedEmail.subject)
console.log('Text Body:', parsedEmail.textBody)
console.log('HTML Body:', parsedEmail.htmlBody)

// Process attachments with types
parsedEmail.attachments.forEach((attachment) => {
  console.log('Filename:', attachment.filename)
  console.log('Content Type:', attachment.contentType)
  console.log('Size (bytes):', attachment.size)
  console.log('Download URL:', attachment.url)
})

// Access headers and metadata
console.log('Message ID:', parsedEmail.messageId)
console.log('Date:', parsedEmail.date)
console.log('In Reply To:', parsedEmail.inReplyTo)
console.log('References:', parsedEmail.references)

// Custom headers
console.log('Custom Headers:', parsedEmail.headers)

Flexible Integration Options

badge 13

REST API

Standard REST endpoints for parsing emails from any language or framework.

POST /v2/emails/parse
GET /v2/emails/{id}
badge 13

Real-time Webhooks

Automatic parsing with webhook delivery for real-time email processing workflows.

Auto-parse incoming emails
Webhook delivery <2s
badge 13

TypeScript SDK

Native SDK with full type definitions and IntelliSense support for faster development.

bun add @inboundemail/sdk
Full TypeScript support

Common Email Parsing Scenarios

Support Ticket Creation

Parse support emails to automatically create tickets with proper categorization and routing.

// Extract ticket data from email
const ticket = {
customer: email.parsedData.from.address,
subject: email.parsedData.subject,
description: email.parsedData.textBody,
attachments: email.parsedData.attachments
}

Order & Invoice Processing

Parse order confirmations, invoices, and receipts to extract structured business data.

// Extract order data
const orderData = parseOrderEmail(email.parsedData)
// orderId, amount, items, customer

Lead Qualification

Parse contact form emails to extract lead information and automatically score prospects.

// Extract lead data
const lead = extractLeadData(email.parsedData)
// Auto-score and route to sales

Simple Email Parsing Pricing

Start with 1,000 parsed emails free every month. Scale affordably as your email processing grows.

badge 13

Ready to Parse Emails Like a Pro?

Join thousands of developers who trust inbound for professional email parsing and processing.

✓ 1,000 emails/month free ✓ TypeScript SDK ✓ Structured data ✓ No setup fees

Email Parsing API - Extract Structured Data from Emails | inbound | inbound