Documentation

Kovarro Mail is a self-hostable email platform. These docs cover the developer surface — the REST API, SMTP relay, webhook contract, and the official SDK.

Getting started

Add a sending domain, issue an API key, send your first email — all in under ten minutes.

Read

API reference

Every endpoint, every field. POST /v1/emails, templates, suppressions, webhooks, keys.

Read

Webhooks

Receive delivery, bounce, open, click events. HMAC verification + retry semantics.

Read

SDKs

Node/TypeScript today. PHP and Python on the roadmap. Or use the REST API directly.

Read

Conventions

Base URL. This instance is at https://api.example.com/v1/. Every endpoint below lives under that prefix.
Authentication. Send Authorization: Bearer nm_… with every request. Keys are tenant-scoped — see API keys.
Versioning. The path includes the major version. We will never break /v1/ — breaking changes ship under /v2/.
Rate limits. Per-API-key token bucket — default 10 requests/second sustained with bursts up to 20. Every response carries X-RateLimit-Limit / X-RateLimit-Remaining; a 429 includes Retry-After seconds.
Idempotency. Send idempotencyKey on POST /v1/emails — repeats with the same key return the original result instead of sending again. Safe to retry.