Sandbox Mode

Sandbox Mode provides you with a dedicated sandbox email address for testing your email integration without affecting real users.

Key Benefits:

Dedicated sandbox email address for testing
Real emails sent normally
View captured test emails in Sandbox Inbox
Auto-expiration after 7 days

How It Works

When you enable Sandbox Mode, you receive a unique sandbox email address (e.g., [email protected]). Any emails sent to this address are captured in your Sandbox Inbox for testing, while all other emails are sent normally to their recipients.

Quick Start

Get Your Sandbox Email Address

Go to Dashboard → Settings → Sandbox
Toggle Enable Sandbox Mode
Copy your unique Sandbox Email Address
Click Save Changes

Send Test Email

Use your sandbox email address as the recipient:

curl -X POST https://api.keplars.com/api/v1/send-email/instant \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["[email protected]"],
    "subject": "Test Email",
    "body": "This email will be captured in Sandbox Inbox"
  }'

Response:

{
  "success": true,
  "data": {
    "id": "sandbox-019c2a86-8759-71c5-8841-428ed394c598",
    "sandbox": true,
    "status": "captured",
    "priority": "instant",
    "recipients": 1,
    "message": "Email captured in sandbox mode. View in Test Inbox."
  }
}

View in Sandbox Inbox

Go to Dashboard → Sandbox Inbox
View all captured test emails with full content
Inspect recipients, subject, body, and metadata

Sandbox Inbox

Viewing Captured Emails

Navigate to Dashboard → Sandbox Inbox to view all emails sent to your sandbox address. Each email shows:

Recipients (To addresses)
From address
Subject line
HTML body content
Priority level
Capture timestamp
Expiration date (7 days from capture)

Sandbox emails are automatically deleted after 7 days.

Template Emails in Sandbox

Sandbox mode works with template-based emails:

curl -X POST https://api.keplars.com/api/v1/send-email/instant \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["[email protected]"],
    "template_id": "019ba4a2-3374-7241-8c83-fb4ec1b1d859",
    "params": {
      "userName": "Test User",
      "orderNumber": "12345"
    }
  }'