Transactional email platform

Send reliable email via API & SMTP

Self-hosted MailHub gives you domain DNS guidance, DKIM signing, delivery logs, and signed webhooks — without locking you into a black-box SaaS.

Get started View API sample

Self-hosted
DKIM
SPF
DMARC
Delivery webhooks

curl

Built for production senders

Everything you need to authenticate domains and observe delivery.

Domains & DNS

Guided SPF, DKIM, DMARC, and one-click DNS provider writes.

SMTP Submission

App-friendly SMTP listeners with credentials you control.

HTTP Send API

Bearer tokens and a simple JSON send endpoint for apps and services.

Mailboxes & receiving

Create persistent or expiring inboxes with IMAP, POP3, forwarding, and catch-all routing.

Delivery logs

Track queue and MTA outcomes with searchable send history.

Webhooks

Signed callbacks for sent, bounced, and failed terminal events.

Multi-user isolation

Domains, tokens, and logs stay scoped to each account.

Start in four steps

The console keeps domain, token, mailbox, and delivery configuration in one place.

Add a domain

Add your sending domain and publish the DNS records shown by MailHub.

Review domain setup →

Create a scoped token

Give each integration only the send or mailbox permissions it needs.

Review API access →

Provision mailboxes

Create persistent mailboxes in the console or create persistent and temporary mailboxes by API.

Review mailbox API →

Connect your client

Use SMTP to send and IMAP or POP3 to receive with the mailbox's full address and password.

Review protocol settings →

Send API

Minimal JSON contract. Hostnames below are placeholders — replace with your MailHub host.

POST /api/send

from — sender address on a verified domain
to — recipient string or array
subject — message subject
text / html — message body

Mailbox API and clients

Create a persistent address for ongoing work, or an expiring address for a short-lived workflow.

Create a mailbox

POST to /api/mailboxes with a token holding mailboxes:write. The target domain must belong to that account.

mode — permanent or temporary
address / domain — use a full address, or let a temporary mailbox generate one from domain
expiresInMinutes — required for temporary mailboxes; 5 minutes to 30 days
password — optional; a secure password is returned once when omitted

Use the returned configuration

Creation returns the address, password, expiration, and ready-to-use IMAP, POP3, and SMTP settings.

IMAP — recommended for synchronized folders and sent mail
POP3 — for download-oriented clients
SMTP — use the same full mailbox address and password to send

POST /api/mailboxes

Use GET /api/mailboxes with mailboxes:read to list the account's mailboxes. A temporary mailbox stops accepting mail and authenticating at its expiration time.

Domain configuration

Create the domain in MailHub first. Its DNS panel is the source of truth for your exact verification, DKIM, SPF, DMARC, and sender-host values.

Purpose	Record	Requirement
Domain ownership	`TXT _mailhub.<domain>`	Publish the verification value generated in the console.
DKIM	`TXT <selector>._domainkey.<domain>`	Publish the public key generated for this domain.
SPF	`TXT <domain>`	Keep one SPF record and include the sender IP/host required by MailHub.
DMARC	`TXT _dmarc.<domain>`	Start with monitoring, then strengthen the policy after alignment is verified.
Inbound mail	`MX <domain>`	Point MX to the MailHub receiving host and ensure that host has an A/AAAA record.

For reliable delivery, also configure the sending IP's PTR to match the MailHub sending hostname and allow the documented SMTP, IMAP, and POP3 ports through your firewall.

SMTP submission

Default listener ports (override in your deployment):

25smtp

587smtp / STARTTLS

465smtps

2525smtp

Use a mailbox's full address and password for SMTP, IMAP, and POP3. Prefer TLS ports 465, 993, and 995; use STARTTLS/STLS on the plain ports when needed.

Delivery webhooks

Terminal events only — signed HTTPS callbacks to your systems.

Status	type
`sent`	`email.sent`
`bounced`	`email.bounced`
`failed`	`email.failed`

Signature header: X-MailHub-Signature: t=<unix>,v1=<hmac>

Ready to send?

Create an account, add a domain, and ship your first message in minutes.

Get started Log in