Migrate from Mailgun

Overview

Unosend offers a modern, developer-friendly alternative to Mailgun with transparent pricing and a simpler API surface. Why switch:

Predictable pricing — flat monthly plans vs Mailgun’s per-email pricing
Modern API — JSON-first design vs Mailgun’s form-data approach
Built-in features — broadcasts, SMS, WhatsApp, and validation included
No vendor lock-in — simple REST API compatible with any language

Migration Steps

1. Create Your Unosend Account

Sign up at unosend.co/signup
Add and verify your sending domain
Generate an API key

2. Update Environment Variables

- MAILGUN_API_KEY=key-xxxxxxxxxxxx
- MAILGUN_DOMAIN=mg.yourdomain.com
+ UNOSEND_API_KEY=un_xxxxxxxxxxxx

3. Update Your Code

Node.js
Python
cURL

Before (Mailgun):

const Mailgun = require('mailgun.js');
const formData = require('form-data');
const mailgun = new Mailgun(formData);
const mg = mailgun.client({ username: 'api', key: process.env.MAILGUN_API_KEY });

await mg.messages.create('mg.yourdomain.com', {
  from: 'hello@yourdomain.com',
  to: ['user@example.com'],
  subject: 'Hello',
  html: '<p>Welcome!</p>'
});

After (Unosend):

import { Unosend } from 'unosend';
const unosend = new Unosend(process.env.UNOSEND_API_KEY);

await unosend.emails.send({
  from: 'hello@yourdomain.com',
  to: ['user@example.com'],
  subject: 'Hello',
  html: '<p>Welcome!</p>'
});

Before (Mailgun):

import requests

requests.post(
    'https://api.mailgun.net/v3/mg.yourdomain.com/messages',
    auth=('api', os.environ.get('MAILGUN_API_KEY')),
    data={
        'from': 'hello@yourdomain.com',
        'to': ['user@example.com'],
        'subject': 'Hello',
        'html': '<p>Welcome!</p>'
    }
)

After (Unosend):

import requests

requests.post('https://www.unosend.co/api/v1/emails',
    headers={'Authorization': f'Bearer {os.environ.get("UNOSEND_API_KEY")}'},
    json={
        'from': 'hello@yourdomain.com',
        'to': ['user@example.com'],
        'subject': 'Hello',
        'html': '<p>Welcome!</p>'
    }
)

Before (Mailgun):

curl -s --user 'api:key-xxxx' \
  https://api.mailgun.net/v3/mg.yourdomain.com/messages \
  -F from='hello@yourdomain.com' \
  -F to='user@example.com' \
  -F subject='Hello' \
  -F html='<p>Welcome!</p>'

After (Unosend):

curl -X POST https://www.unosend.co/api/v1/emails \
  -H "Authorization: Bearer un_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"from":"hello@yourdomain.com","to":["user@example.com"],"subject":"Hello","html":"<p>Welcome!</p>"}'

JSON body instead of form data — cleaner and more consistent.

4. Update DNS Records

Remove Mailgun’s DNS records and add Unosend’s:

Type	Name	Value
TXT	`unosend._domainkey`	Your DKIM public key
MX	`send`	`10 mail.unosend.co`
TXT	`send`	`v=spf1 include:_spf.unosend.co ~all`

Key Differences

Feature	Mailgun	Unosend
Auth	Basic Auth (`api:key-xxx`)	Bearer token (`Bearer un_xxx`)
Content type	`multipart/form-data`	`application/json`
Domain in URL	Required (`/v3/{domain}/messages`)	Not required
Webhooks	Signature-verified	Bearer token verified
Templates	Handlebars	Mustache variables
Logs	3-day retention (free)	Plan-based (3–30 days)

Pricing Comparison

Emails/Month	Mailgun	Unosend	Savings
50,000	$35/mo (Foundation)	$20/mo	43%
100,000	$75/mo	$50/mo	33%
500,000	$350/mo	$340/mo	3%
1,000,000	$700/mo	$600/mo	14%

Unosend includes broadcasts, SMS, WhatsApp, and validation — Mailgun charges extra for these.

Quick Start Guide

Get sending in under 5 minutes

Getting Started

Guides

Integrations

Migration

Tools

Resources

Migrate from Mailgun

Overview

Migration Steps

1. Create Your Unosend Account

2. Update Environment Variables

3. Update Your Code

4. Update DNS Records

Key Differences

Pricing Comparison

Quick Start Guide

Getting Started

Guides

Integrations

Migration

Tools

Resources

​Overview

​Migration Steps

​1. Create Your Unosend Account

​2. Update Environment Variables

​3. Update Your Code

​4. Update DNS Records

​Key Differences

​Pricing Comparison

Quick Start Guide

Overview

Migration Steps

1. Create Your Unosend Account

2. Update Environment Variables

3. Update Your Code

4. Update DNS Records

Key Differences

Pricing Comparison