Using the Kerabie Mail API
The Kerabie Mail REST API lets you send emails, manage contacts, and read your inbox programmatically.
Available on: Pro and Premium plans.
Base URL
https://api.kerabie.email
Authentication
Include your API key in every request:
Authorization: Bearer YOUR_API_KEY
Generate API keys in Settings → API Keys.
Sending an email
POST /mail/send
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
{
"to": ["recipient@example.com"],
"subject": "Hello from the API",
"body": "<p>This was sent via the Kerabie Mail API.</p>",
"from_email": "you@yourdomain.com"
}
Response:
{ "message_id": "abc123", "status": "sent" }
Listing inbox messages
GET /inbox?email=you@yourdomain.com&folder=INBOX&page=1&per_page=20
Authorization: Bearer YOUR_API_KEY
Reading a message
GET /inbox/{uid}?email=you@yourdomain.com
Authorization: Bearer YOUR_API_KEY
Common response codes
| Code | Meaning |
|---|---|
| 200 | Success |
| 201 | Created |
| 204 | Deleted (no content) |
| 400 | Bad request — check your payload |
| 401 | Invalid or missing API key |
| 403 | Feature not available on your plan |
| 404 | Resource not found |
| 429 | Rate limit exceeded |
Rate limits
| Plan | Requests/minute |
|---|---|
| Pro | 60 |
| Premium | 300 |
Full API reference
The complete API reference with all endpoints, parameters, and response schemas is available at api.kerabie.email/docs (Swagger UI).