Get started

Introduction

MailAfrica is a developer-first email infrastructure platform for Africa. Create sender IDs, receive inbound email via webhooks, send transactional email, and manage wallet balance and top-ups with a single API.

Everything you need to integrate MailAfrica programmatically — no dashboard clicks required once you have an API key.

What MailAfrica gives you

Sender IDs — create discrete inbound addresses (hello@mailafrica.online) programmatically, up to 100 per account.
Inbox webhooks — get pushed inbound.message_received events the instant mail lands, HMAC-signed so you can verify them.
Outbound email — send transactional email from the platform (noreply@mailafrica.online) or your own verified sending domain.
AI auto-reply — per-address AI answers to inbound mail in off, draft, or auto mode.
SMS notifications — forward a short summary of inbound mail to a phone number.
TZS native — all pricing in Tanzanian Shillings, debited from a single wallet balance.
Balance & top-up — read your balance and start a mobile-money or card top-up over the API.
Sandbox — test the whole flow with disposable SMTP credentials, no real mail.

Base URLs

Environment	Base URL
Production API	`https://api.mailafrica.online`
Dashboard	`https://app.mailafrica.online`
Documentation	`https://docs.mailafrica.online`

There is one production base URL. Every request is scoped to your account by your API key — you can only ever read or write your own data, never the platform's internal data or another user's data.

How the API stays secure

MailAfrica is designed so that programmatic integrations only ever see their own resources:

API keys are account-scoped — a key issued to your account can only access your sender IDs, addresses, messages, webhooks, domains, and balance.
No internal endpoints — operator/admin surfaces are not part of the public API and are never reachable with a developer key.
Secrets are single-show — plaintext API keys, webhook secrets, SMS keys, and sandbox passwords are returned exactly once; store them safely.
Webhooks are verifiable — every delivery carries an HMAC-SHA256 signature you can check before trusting the payload.
Wallet-gated — each message debits your balance, so spend is bounded by what you top up.

Pricing at a glance

MailAfrica is pay-per-message on a single flat rate: 5 TZS per message — the same price whether you receive on the platform domain or your own verified domain, and whether you send from the platform sender or your own verified sending domain. No subscriptions, no tiers.

Message	Price
Inbound (any address, platform or your own verified domain)	5 TZS per message
Outbound (each recipient, platform or your own verified domain)	5 TZS per recipient

Next steps

Register an account and verify your email or phone.
Create an API key for your integration.
Create your first sender ID and receive mail.
Wire up an inbox webhook to react in real time.
Check your balance and top up — billing is per message from your wallet.

Machine-readable docs

Every page is also plain markdown (/outbound.md, /webhooks.md, …), the whole site compiles to `llms.txt` and `llms-full.txt`, and a full OpenAPI 3.1 spec lives at `openapi.json` — see Integrate with AI Assistants.