Schedule an email
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.
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
curl -X POST "https://api.keplars.com/api/v1/send-email/schedule" \ -H "Content-Type: application/json" \ -d '{ "scheduled_at": "2026-06-01T09:00:00.000Z", "timezone": "America/New_York", "email": { "to": [ "[email protected]" ], "from": "[email protected]", "subject": "Your weekly digest", "body": "<p>Here is your weekly digest...</p>", "is_html": true } }'{
"id": "scheduled_msg_1748000000000_a1b2c3",
"object": "scheduled_email",
"status": "scheduled",
"scheduled_at": "2019-08-24T14:15:22Z",
"timezone": "America/New_York",
"from": "[email protected]",
"to": [
"[email protected]"
],
"subject": "string",
"created_at": "2019-08-24T14:15:22Z",
"metadata": {
"priority": "instant",
"estimated_delivery": "string",
"recipients_count": 0
}
}{
"success": false,
"error": "VALIDATION_ERROR",
"message": "Field 'to' is required"
}{
"success": false,
"error": "VALIDATION_ERROR",
"message": "Field 'to' is required"
}Examples
End-to-end code examples for common Keplars API workflows.
Send async email POST
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.