/ /
Sandbox API Service

Sandbox API

Sending millions of emails needs testing infrastructure before mass deployment. Our sandbox systems help businesses stay compliant with GDPR, CAN-SPAM and Data protection standards.

Sandbox API for Email Testing
API Explorer

Lower Errors & Enhance Deliverability With Sandbox API

Now, we will test, fix, and boost every part of email campaigns before we make them live.

API Request Flow

Send Request

Call any endpoint with your API key. RESTful, predictable, and fast.

GET /v1/messages
Authorization: Bearer ts_key

Process & Analyze

TrueSend fetches data, runs spam analysis, validates HTML, and checks auth.

spam_check: 0.8/5.0
dkim: pass  spf: pass

JSON Response

Get structured JSON with emails, scores, headers, and validation results.

{ "status": 200,
  "data": [{ "subject": "..." }] }
GET
/v1/messages

Email Campaign Testing

Test email content, subject lines, templates, and personalisation before sending real campaigns.

GET
/v1/messages/{id}

Process of Automation Testing

Automatically test welcome emails, cart recovery and drip flows to ensure that every trigger fires at the right time.

POST
/v1/html-check

API Request & Response Test

Analysing the results and sending sample API calls helps you achieve proper integration and data flow.

GET
/v1/inboxes

Contact & Data Simulation

Trigger events like clicks, purchases, or signups and make test contacts. It will test the behaviour of the actual campaign without hassles.

GET
/v1/messages/{id}/spam

Template Rendering Preview

Check how your emails look across multiple devices and inbox clients. Don't compromise on formatting & design.

DEL
/v1/inboxes/{id}/clean

Logs & Debug View

Watch all test activity, API responses, and errors. This allows you to find and fix issues without hassle before they move to production.

How It Works

Using the Sandbox API

Start using the sandbox API in 4 simple steps.

1

Log into your ESP Dashboard

Log into your ESP account, and there you can check sandbox tools and settings.

2

Generate Sandbox API Key and Secret

Use the sandbox environment with utmost safety by creating secure test credentials.

3

Open the API Explorer and Send a Test Request

You can use the testing tool bundled with this API and easily test API calls and email functionality.

4

Review Outcomes and Problem Fixes

Review responses, find errors and correct them before going to production campaigns.

Quick Start

Get Started in Any Language

Get started with TrueSend's Sandbox API using SDKs for Node.js, Python, PHP, Ruby, Go, and Java, or connect directly via the REST API in any programming language.

Compare Plans
// Node.js  Spam Check API
const axios = require('axios');
const res = await axios.get
  'https://api.truesend.io/v1/messages',
    params: { to: 'user@test.com' },
    headers:
      'Authorization': 'Bearer ts_api_key'
const email = res.data[0];
//  0.8
console.log(email.dkim_valid);
//  true
console.log(email.spf_result);
//  "pass"
Related Tools

A Toolkit for the Sandbox API

Harness a complete set of embedded utilities to back secure testing, debugging, and optimisation of email campaigns.

Sandbox API Credentials Manager

Generate and manage API keys and secrets for secure access to the sandbox environment.

Learn More

Email Testing Simulator

Authenticate delivery flow and content by sending controlled test emails. These emails don't have to reach real users.

Learn More

Event & Automation Simulator

Activate sample user actions including signup or purchase.

Learn More
FAQ

Frequently Asked Questions

Everything you need to know about TrueSend's Sandbox API

Sandbox API FAQ
Does the sandbox API support tracking like opens and clicks?
Yes, but tracking is simulated. Testing event triggers such as clicks or opens is the right. But they do not reflect real user behaviour.
Can I use real customer data in sandbox testing?
You can use limited or masked test data because if you use full real customer data, you may face a protection issue and accidental sends.
What happens if we skip sandbox testing?
If you skip sandbox testing, it can result in broken campaigns going live. Moreover, it can also lead to loss of customer trust, reduced engagement and sales, and deliverability problems.
Do sandbox emails go to the inbox or spam?
Sandbox emails don't land in the actual inboxes. In fact, they're generally captured inside the platform. Or they're shown as test logs for debugging purposes.
What can I test using the sandbox API?
With the sandbox API, you can test email templates, automation workflows, API integrations, trigger events, and email rendering.

Deliver Your Best Work With TrueSend

  • No Credit Card Needed
  • Unlimited Time On Free Plan