Skip to main content
Documentation

CoffeeMail Documentation

Everything you need to integrate transactional email into your application using official SDKs (Node.js and Python) or the REST API.

API base URL

All Product API endpoints live at https://api.coffeemail.com.br/v1/product/*. Official SDKs connect directly to this production URL out of the box.
Quickstart
Send your first email in 5 minutes with official SDKs or cURL.
Guides
Step-by-step tutorials for common scenarios.
Node.js SDK
Full reference for the @coffeemail/node package, grouped by resource.
Concepts
Lifecycle, DNS, idempotency, pagination and suppressions, independent of language.
Errors
Real statuses, codes and the API { error } envelope.
API Reference
Public REST endpoints (Product API) consumed via API Key.
Security & Compliance
LGPD, ISO 27001, SOC 2. Data retention and encryption.

What CoffeeMail delivers

A self-hosted transactional email platform built for Brazilian engineering teams.

Official typed SDKs

Strongly-typed official libraries with safe data, error returns. Available now for Node.js (@coffeemail/node) and Python (coffeemail), with PHP, Ruby, and Go in active development.

REST API

JSON endpoints under /v1/product/* authenticated via Bearer cm_live_*. Documentation and Zod schemas open.

Signed webhooks

Receive email.delivered, email.bounced and more with HMAC SHA-256 signatures verifiable locally.

Automatic deliverability

DKIM per domain, aligned SPF, DMARC with reports, intelligent IP warmup and global suppression list.