Setup Guide

Mailgun Integration Setup

Follow these steps to enable real email forwarding using Mailgun. This will allow your hidden email addresses to receive and forward emails to your primary inbox.

1

Create a Mailgun Account

Sign up for a free Mailgun account at mailgun.com

Mailgun offers a free tier with 5,000 emails per month, which is perfect for personal use.

2

Add and Verify Your Domain

  1. Go to Sending → Domains in Mailgun
  2. Click Add New Domain
  3. Enter your domain (e.g., hidemyemail.app)
  4. Add the DNS records Mailgun provides to your domain's DNS settings
  5. Wait for verification (usually takes a few minutes)
3

Get Your API Credentials

  1. Go to Settings → API Keys
  2. Copy your Private API Key
  3. Note your Domain Name from the Domains page
4

Configure Webhook Signing Key

  1. Go to Settings → Webhooks
  2. Copy your HTTP webhook signing key
  3. Keep this safe - you'll need it in the next step
5

Add Environment Variables

When you mention these in chat, you'll be prompted to enter the values:

MAILGUN_API_KEY = your-private-api-key
MAILGUN_DOMAIN = yourdomain.com
MAILGUN_WEBHOOK_SIGNING_KEY = your-webhook-signing-key
6

Set Up Mailgun Route

  1. Go to Sending → Routes
  2. Click Create Route
  3. Expression Type: Match Recipient
  4. Recipient: .*@yourdomain.com (catches all emails)
  5. Actions: Forward to URL
  6. URL: https://your-app-url/api/email/webhook
  7. Priority: 0 (highest)

You're All Set!

Once configured, any email sent to your hidden addresses will be automatically forwarded to your primary email. Deactivated addresses will stop receiving mail immediately.

Back to Dashboard