Technical Architecture & API Reference

Inboxbees is a serverless, multi-tenant webmail engine running on Cloudflare Workers, Cloudflare D1 (SQLite + FTS5), and Cloudflare R2 object storage.

1. Universal Inbound Pipeline

Inboxbees ingests incoming emails through 4 modular adapters:

Adapter A: Cloudflare Email Routing

Catch-all relay directly via Cloudflare Worker email() handler. Streaming ingestion directly into R2.

Adapter B: Brevo Inbound Webhook

For registrars where MX records can be edited. Ingests via Brevo inbound webhook token.

Adapter C: OAuth API Connectors

Direct sync and send with Gmail (REST API) and Microsoft Outlook (Graph API) via OAuth2.

Adapter D: Forwarded Inboxes

Zero-DNS personal mailbox ingestion via dedicated relay forwarding addresses.

2. BYOK Multi-Provider Outbound Matrix

Outbound emails are dispatched through your encrypted API keys using automatic failover fallback across 4 supported providers:

Resend APIBrevo (Sendinblue)Mailjet APIAWS SES (v2)

3. REST API & Webhooks

GET/api/v1/mails?folder=inbox&address_key=alex

POST/api/v1/send

POST/api/v1/send/schedule

GET/api/v1/events (Server-Sent Events)

POST/api/webhooks/resend, /brevo, /mailjet, /ses