Send async email
Normal priority queue. Use for regular transactional emails like receipts, welcome emails, and account updates. Typically delivered within 5 minutes.
Processing time: 0–5 minutes. Retries: 3. This is the recommended endpoint for most use cases.
Authorization
bearerAuth Bearer token authentication. Use a Regular API key for email sending, or an Admin API key for marketing and automation endpoints.
Get your API keys from Settings → API Keys (regular) or Settings → Admin API Keys (admin) in the dashboard.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://api.keplars.com/api/v1/send-email/async" \ -H "Content-Type: application/json" \ -d '{ "to": [ "[email protected]" ], "from": "[email protected]", "subject": "Welcome to Yourapp", "body": "<h1>Welcome, John!</h1><p>Thanks for signing up.</p>", "is_html": true }'{
"id": "msg_1748000000000_a1b2c3",
"object": "email",
"status": "queued",
"from": "[email protected]",
"to": [
"[email protected]"
],
"subject": "string",
"created_at": "2019-08-24T14:15:22Z",
"metadata": {
"priority": "instant",
"estimated_delivery": "0-5 seconds",
"recipients_count": 0
}
}{
"success": false,
"error": "VALIDATION_ERROR",
"message": "Field 'to' is required"
}{
"success": false,
"error": "VALIDATION_ERROR",
"message": "Field 'to' is required"
}{
"success": false,
"error": "VALIDATION_ERROR",
"message": "Field 'to' is required"
}Schedule an email POST
Schedule an email to be sent at a specific time in the future. `scheduled_at` must be an ISO 8601 datetime in the future. Maximum scheduling window: 30 days. Requires LAUNCH plan or higher.
Send bulk email POST
Low priority queue. Use for **marketing newsletters and promotional emails** that are processed when the queue is idle. Processing time: variable (background). Retries: 3. Not suitable for time-sensitive emails.