Getting Started

Welcome to Mailpipe! This guide will help you set up your programmable email client and start routing emails to your Supabase database in minutes.

Prerequisites

Before you begin, make sure you have:

• A Supabase account and project
• An email provider account (Postmark, Mailgun, SendGrid, Resend, or AWS SES)
• A domain you control for receiving emails

Quick Start

1. Sign Up for Mailpipe

Create your Mailpipe account and connect your Supabase project. We'll guide you through the database setup automatically.

2. Configure Your Domain

Add your domain to Mailpipe and update your DNS records. We support any domain and provide step-by-step DNS configuration guides.

# Example MX record for your domain
@ MX 10 inbound.mailpipe.dev

# TXT record for verification
mailpipe._domainkey TXT "v=DKIM1; k=rsa; p=..."

3. Set Up Email Routing Rules

Create routing rules to determine how emails are processed. You can route based on sender, recipient, subject, or custom patterns.

// Example routing rule configuration
{
  "name": "Support Tickets",
  "match": {
    "to": "support@yourdomain.com"
  },
  "action": {
    "table": "support_tickets",
    "transform": {
      "subject": "$.subject",
      "body": "$.text_body",
      "sender_email": "$.from.email"
    }
  }
}

4. Connect Your Email Provider

Configure your email provider's inbound webhook to point to your Mailpipe endpoint. We support all major providers:

• Postmark - Inbound message webhooks
• Mailgun - Routes and webhooks
• SendGrid - Inbound Parse
• Resend - Webhooks
• AWS SES - SNS notifications

Next Steps

Now that you have the basics set up, explore these guides to unlock the full potential of Mailpipe:

• Supabase Setup - Detailed database configuration and RLS policies
• Email Providers - Provider-specific setup guides
• API Reference - Complete API documentation