API Reference
SipherMail provides a REST API for programmatic access to your mailbox. Use it to send email, query folders, and receive real-time delivery webhooks.
Base URL
https://siphermail.com/apiAuthentication
The API supports two authentication methods:
- Bearer JWT — Used by mobile apps and external API clients. Include the token in the
Authorizationheader:Authorization: Bearer <token> - Session cookie — Used by the web client. Automatically managed by the browser.
See Authentication for how to obtain a JWT.
Rate limits
| Plan | Requests / minute | Send limit / day |
|---|---|---|
| Free | 60 | 100 emails |
| Pro | 300 | 1,000 emails |
| Business | 1,000 | 5,000 emails |
Response format
All API responses return JSON with an ok boolean:
// Success
{ "ok": true, "data": { ... } }
// Error
{ "ok": false, "error": "Description of the error" }API endpoints
- Authentication — Get and refresh JWT tokens.
- Send Mail — POST /api/send — send an email.
- Folders — List and manage folders.
- Webhooks — Receive real-time delivery events.
SDK support
There is no official SDK yet. The API is a standard REST API consumable from any HTTP client. Community SDKs may be listed on the SipherMail GitHub.