Introduction
Mailcycle is private email infrastructure with an HTTP API. Everything the Mailcycle apps do goes through this API, so your code can create email addresses, pair devices, read mail and send it.
The API lives at:
https://api.mailcycle.emailIt speaks JSON and authenticates with a bearer token: an API key on Operator and above, or a session from the recovery-phrase handshake on any plan.
What comes back encrypted
Section titled “What comes back encrypted”Message content, attachments, address labels and device names are sealed on a device before they are stored, with keys derived from your recovery phrase. The API returns them as sealed blobs, and only a client holding those keys can open them. See Encryption and sealed data.
Start here
Section titled “Start here”QuickstartMake an API key and your first request.
AuthenticationAPI keys, sessions and device credentials.
API referenceEvery endpoint, error code and limit.
Pairing devicesAdd a phone or browser to an account.
What is built
Section titled “What is built”| Feature | Status |
|---|---|
| REST API over accounts, devices, email addresses, messages and billing | Available |
| Sessions from the recovery-phrase handshake | Available |
| API keys, Operator plan and up | Available |
| Device pairing and device credentials | Available |
| Webhooks | Planned |
| Hosted event stream and SDKs | Planned |