Migrate from Mailgun

Migrate off Mailgun without stopping sending.

Export your contacts and your unsubscribes from Mailgun, upload both, and Notix brings them over in the right order. No key, nothing to revoke afterwards. Your Mailgun account keeps sending the whole time.

Start the migration Book a free migration call

CSV upload, no key needed

Code converter

Paste your Mailgun code, get the Notix version

Load an example or paste your own send call: Node.js, Python, PHP or cURL. Anything that does not have a Notix equivalent is listed under the result.

Your Mailgun codeNode.js, detected

Notix, Node.js (notix-js)

import { Notix } from "notix-js";

const notix = new Notix(process.env.NOTIX_API_KEY);

const { data, error } = await notix.emails.send({
  from: "Acme <orders@acme.com>",
  to: "amara@example.com",
  subject: "Your order is on its way",
  html: "<p>Your parcel left our warehouse today.</p>",
});

Tags and categories were not converted: a Notix send has no tags field. Use your own header if you need to label mail.

The converter reads the code as text in your browser. It does not run it, store it or send it anywhere.

Migration Center

Move your audience in one sitting

Upload the files Mailgun already lets you export. The Migration Center shows you what it found before it writes anything.

What comes across, in this order

Your unsubscribe and bounce export, first, as suppressions
Your contact export, with columns mapped to properties
Each file into the contact book you choose

Templates come across from SendGrid only. From anywhere else, rebuild them in the editor or start from the 54 starter templates.

Your exports

Suppressions → Export unsubscribes, bounces and complaints.

CSV

What happens to your files

The uploaded files are kept for one hour while the import runs and dropped when it finishes.

Held 1 hour

Four weeks

How the migration goes

Day one
Connect or upload
Paste an API key, or upload your contacts and unsubscribes as CSV. Nothing is written until you have seen what we found.
During the import
Unsubscribes first
Every unsubscribe, bounce and complaint is written before the first contact, so nobody who opted out at your old provider can be emailed from Notix.
During the import
Your lists and fields
Contacts land in contact books you choose, with your custom fields mapped. Anyone suppressed arrives unsubscribed.
Before you send
Add Notix to your domain
Publish our records alongside your old provider's. Both keep sending; DNS has room for both.
Weeks one to four
Move volume gradually
A four-week plan, 15% to 100%, so mailbox providers see a sender that grows steadily. Switch the old provider off at the end, not the start.

Where things live

Mailgun's pages, and where to find them in Notix

The console uses the same words throughout: Emails, Broadcasts, Automations, Templates, Audience, Metrics, Logs, Webhooks and API keys.

Mailgun's names as their dashboard shows them; Notix names as the console shows them.
In Mailgun	In Notix	Good to know
Sending > Logs	Emails	API calls are on Logs.
Reporting and metrics	Metrics	Same idea, same place.
Templates	Templates	Same idea, same place.
Suppressions	Emails > Suppressions	Same idea, same place.
Mailing lists	Audience	Same idea, same place.
Domains and DNS records	Domains	Same idea, same place.
API security (keys)	API keys	Same idea, same place.
SMTP credentials	Settings > SMTP	The password is an API key.
Webhooks	Webhooks	Same idea, same place.
Receiving (routes)	Emails > Receiving	Forwarding rules replace routes that forward.

SDKs and the API

Send through the API, side by side

The same email, as you send it today and as you send it with Notix.

Notix has official SDKs for Node.js, Python and PHP. Every other language uses the same JSON API.
Language	Mailgun	Notix
Node.js and TypeScript	`mailgun.js`	`notix-js`
Python	`Their HTTP API (requests)`	`notix-sdk`
PHP and Laravel	`mailgun/mailgun-php`	`usenotix/notix-php`
Go, Ruby, Java, .NET and the rest	`Their libraries, or the REST API`	`REST API (JSON over HTTPS)`

Mailgun today

import formData from "form-data";
import Mailgun from "mailgun.js";

const mailgun = new Mailgun(formData);
const mg = mailgun.client({ username: "api", key: process.env.MAILGUN_API_KEY });

await mg.messages.create("mg.acme.com", {
  from: "Acme <orders@acme.com>",
  to: ["amara@example.com"],
  subject: "Your order is on its way",
  html: "<p>Your parcel left our warehouse today.</p>",
  "o:tag": ["shipping"],
});

Notix, with notix-js

import { Notix } from "notix-js";

const notix = new Notix(process.env.NOTIX_API_KEY);

const { data, error } = await notix.emails.send({
  from: "Acme <orders@acme.com>",
  to: "amara@example.com",
  subject: "Your order is on its way",
  html: "<p>Your parcel left our warehouse today.</p>",
});

SMTP

SMTP settings, side by side

Mailgun's settings as their docs describe them; check your own account for the exact values.
Setting	Mailgun	Notix
Host	`smtp.mailgun.org (smtp.eu.mailgun.org in the EU)`	`smtp.usenotix.dev`
Ports	`587, 2525 or 25 (STARTTLS), 465 (TLS)`	`465 (TLS) or 587 (STARTTLS)`
Username	`Your SMTP login, such as postmaster@your-domain`	`notix`
Password	`That login's SMTP password`	`An API key`

Mailgun gives each domain its own SMTP logins. On Notix one API key works for every verified domain on your team.

Webhooks

Your events, by their new names

Every Notix webhook is signed with X-Notix-Signature and retried up to six times. Point a new endpoint at Notix and match the names below.

Mailgun's event names as their docs list them; Notix names as they arrive in the X-Notix-Event header.
Mailgun	Notix	Good to know
`accepted`	`email.queued`
`delivered`	`email.delivered`
`temporary_fail`	`email.delivery_delayed`
`permanent_fail`	`email.bounced`	The reason is in the payload.
`opened`	`email.opened`
`clicked`	`email.clicked`
`complained`	`email.complained`
`unsubscribed`	`contact.unsubscribed`
`Routes (inbound)`	`email.received`

Security and safety

What protects your mail and your data

Suppressions before contacts

The importer enforces the order. Someone who opted out at Mailgun cannot get mail from Notix.

Keys with limits

Give each app the key it needs: full access, or sending only.

Signed webhooks

Every delivery carries an HMAC signature and a timestamp, so your handler can refuse anything forged or replayed.

Logs without secrets

API request logs are kept 30 days. Keys, codes, email bodies and attachments are hidden before a log is saved.

A domain that protects itself

If bounces or complaints climb past safe levels, the domain pauses before it damages your reputation. How it works.

A second pair of eyes

The first broadcast to imported contacts is reviewed by us before it goes out.

Idempotency

Retries never send twice

Send an Idempotency-Key header, up to 256 characters, with any send or batch. Notix keeps the result for 24 hours: a retry with the same key and body gets the first answer back, marked Idempotent-Replayed: true, and the same key with a different body is refused with a 409.

In notix-js it is one option: emails.send(payload, { idempotencyKey }). See it in action.

Also in your account

What else comes with Notix

SMS and one-time codes

Send sign-in codes by SMS or email, with a risk check first, and verify them in one call. One-time codes.

Connect your AI

Claude, ChatGPT or Cursor can work with Notix, and live keys ask you first above a limit you set. Connect your AI.

Pay in NGN, KES or USD

Top up a wallet in naira, shillings or dollars, and Pro renews from it. Pricing.

Inbound and forwarding

Receive mail on your own domain and forward it on, with an optional forwarded-message header. Inbound email.

Broadcasts and automations

Campaigns to a list, segment or topic, and email sequences that run themselves, behind the same key.

DNS

Your SPF record keeps both

A domain may only have one SPF record, so you add Notix to the line you already have rather than replacing it. Keep include:mailgun.org while Mailgun is still sending, add include:_spf.usenotix.dev beside it, and remove Mailgun's once you have switched off.

Pricing

What it costs

What you would pay on Notix

Migrating from

Emails a month

Provider	Plan	A month
Mailgun	Foundation	$35
Notix	Pro	$15

You would save about $240 a year.

Mailgun list price, approximate, checked 13 Sep 2026: their pricing page. Prices change; check before you decide.

FAQ

Questions, answered

Do I have to rewrite my sending code?

Not by hand. Paste your Mailgun send code into the converter on this page to get the Notix version, or change four SMTP settings if you send over SMTP.

Will my Mailgun unsubscribes come across?

Yes, and first. The import writes every unsubscribe, bounce and complaint before the first contact, so a person who opted out there cannot be emailed from Notix, even if the rest of the import stops halfway.

Do I need to give Notix a key?

No. Mailgun migrates by the CSV files it already lets you export. The files are kept for one hour while the import runs, then dropped.

Can I keep sending from Mailgun while I migrate?

Yes. Notix's DNS records sit beside Mailgun's, and the migration takes four weeks, from 15% of your volume to all of it. Switch Mailgun off at the end, not the start.

Is there someone who can help?

Yes. Book a free migration call from the contact page and we will look at your setup with you. The first broadcast to imported contacts is also reviewed by us before it goes out.

Start migrating off Mailgun.

Convert your code, bring your audience across with unsubscribes first, and move your volume over four weeks. We are happy to do it with you.