Developers
Build on Mailera's REST API.
Import Microsoft mailboxes, read and send email, move messages out of Spam and receive signed webhooks.
curl https://mailera.app/api/public/v1/mailboxes \ -H "X-API-Key: mh_live_..."Quickstart
- 1
Create an API key
Sign up for free, go to Settings → API keys and choose permissions for your key.
- 2
Import mailboxes
Send a list of mailboxes to the import endpoint and track results for each row.
- 3
Read and send
Fetch messages by folder, read OTP codes, send or reply to email.
Endpoint groups
Mailboxes
Import, check active status, sync, pause and delete mailboxes.
View endpointsMessages
List, read, search, extract OTP codes, send, reply and forward.
View endpointsSpam
Check whether messages land in Inbox or Junk Email, and move them out of Spam.
View endpointsWebhooks
Subscribe to events for new email, email landing in Junk Email and disconnected mailboxes.
View endpoints
API key permissions
Each key can only do what you allow.
| Scope | Allows |
|---|---|
read | Read mailboxes, mail, OTP codes and Inbox/Spam placement |
move | Move mail out of Spam and between folders |
import | Add mailboxes |
sync | Request an immediate sync |
send | Send, reply to and forward mail |
manage | Pause, resume and delete mailboxes |
webhooks | Manage webhooks |
Webhooks
Receive events as soon as email arrives.
Mailera sends POST requests to your URL with an HMAC-SHA256 signature in the X‑MailHub‑Signature header, and automatically retries if your endpoint fails.
message.receivedNew mail arrived in Inboxmessage.junkNew mail landed in Spammailbox.disconnectedThe mailbox lost its connection (token revoked, password changed…)
Limits and details
- Rate limit
- 300 requests/minute per key
- Authentication
- X-API-Key header
- Mailboxes per free workspace
- Up to 1,000 mailboxes
- Pagination
- cursor and next_cursor
- Machine-readable descriptions
- OpenAPI 3.1 · llms.txt