API Documentation

Integrate email capabilities into your application with our simple and powerful REST API.

Authentication

The API uses Bearer Token authentication. You must include your API token in the Authorization header of each request.

Header Format

Authorization: Bearer <YOUR_API_TOKEN>

You can generate and manage your API tokens in the Settings page.

Send Email

POST

/api/send

Send a transactional email. Supports plain text, HTML, and scheduling.

Request Body

Content-Type: application/json

Parameter	Type	Required	Description
from	string	Yes	Sender email address. Must be a verified sender.
to	string	Yes	Recipient email address(es). Comma separated for multiple.
subject	string	Yes	Email subject line.
text	string	No	Plain text version of the email.
html	string	No	HTML version of the email.
cc	string	No	CC recipient(s).
bcc	string	No	BCC recipient(s).
replyTo	string	No	Reply-To address.
scheduledAt	string	No	ISO 8601 date string to schedule the email for future delivery.

Examples

curl -X POST https://your-domain.com/api/send \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "sender@example.com",
    "to": "user@example.com",
    "subject": "Hello World",
    "text": "This is a test email."
  }'

Response

{
  "success": true,
  "id": "email_1234567890"
}

Errors

The API uses standard HTTP status codes to indicate success or failure.

Code	Description
200	Success. The email was queued or sent.
400	Bad Request. Missing required fields or invalid data.
401	Unauthorized. Invalid or missing API token.
500	Internal Server Error. Something went wrong on our end.