Mailgun

Learn how to set up and use Mailgun for sending emails in your application.

SaasPilot comes configured with Resend by default, but you can easily switch to Mailgun. An email provider is required for essential features such as email verification, password resets, and other transactional emails.

Overview

Mailgun is a powerful email service designed for developers. It offers reliable email delivery, detailed analytics, and excellent deliverability rates. It's particularly well-suited for applications that need to send high volumes of transactional emails.

Setup

1. Create a Mailgun Account

1. Visit Mailgun and click Sign Up
2. Complete the registration process
3. Verify your email address
4. Log in to your Mailgun dashboard

2. Add and Verify Your Domain

1. In the Mailgun dashboard, navigate to Sending → Domains
2. Click Add New Domain
3. Enter your domain name (e.g., yourdomain.com)
4. Choose your region (US or EU)
5. Click Add Domain

Verify Your Domain

Mailgun will provide you with DNS records that need to be added to your domain:

1. Copy the DNS records shown in the Mailgun dashboard
2. Log in to your domain registrar (where you bought your domain)
3. Find the DNS settings section
4. Add the following records:
   • TXT records for domain verification
   • MX records for receiving emails (optional)
   • CNAME records for tracking
5. Wait for DNS propagation (can take up to 48 hours, but usually much faster)
6. Return to Mailgun and click Verify DNS Settings

3. Get Your API Credentials

1. In the Mailgun dashboard, go to Settings → API Keys
2. Find your Private API Key (it starts with key-)
3. Copy this key - you'll need it for your configuration
4. Note your Domain Name from the Domains page

4. Configure Environment Variables

Add your Mailgun credentials to your .env file:

.env

MAILGUN_API_KEY=""
MAILGUN_DOMAIN=""