Sandbox Pre-Warmup Integration

Test your pre-warmup integration end-to-end without real costs, DNS changes, or mailbox provisioning. Sandbox orders cost $0 and create production-identical database records, firing the same webhooks you'll see live.

Why use sandbox?

Need	Benefit
Test without costs	$0 orders with zero wallet impact
Validate workflows	DB records, webhooks, and transaction history match production
Fast iteration	No DNS propagation, no real mailbox setup delays
No special code	Integration code works identically in sandbox and production
On-demand reset	Wipe test data in seconds

How sandbox works

What happens in our sandbox

All of these are created identically to production:

CartOrder – Tracks the order

Orders – Individual order records

PartnerWalletTransaction – $0 DEBIT recorded (transaction history looks real)

Domain rows – Sandbox domains registered

Mailbox rows – 3 pre-warmed mailboxes per domain

Subscription rows – Billing records

What gets skipped

Wallet balance checks → always passes (amount is $0)

Stripe invoicing & payment → skipped entirely

DNS record setup → not performed

Export to platform using Microsoft/Google OAuth

Data retention

Call /sandbox/pre-warmup/reset to delete all your sandbox records immediately

Sandbox domains & mailboxes

Each domain comes with 3 pre-warmed mailboxes ready for testing.

Google Workspace domains

Pass serviceProvider: "GOOGLE" with any of these:

sandbox.nexora-tech.com

mail-sandbox.brightplathlabs.com

Microsoft domains

Pass serviceProvider: "MICROSOFT" with any of these:

sandbox-mail.corevista.io

sandbox.stratospherehq.com

Endpoints

Three endpoints available:

GET /sandbox/pre-warmup – List available sandbox domains

POST /sandbox/pre-warmup/order – Place a sandbox order

DELETE /sandbox/pre-warmup/reset – Wipe all sandbox records
See endpoint documentation for full details.

Scenarios – Simulating order outcomes

Control what happens with the scenario field. Useful for testing error handling and partial success flows.

`success` (default)

✅ All domains created

✅ DB records inserted

🔔 prewarmup.order.success webhook fired

💾 Mailboxes provisioned (sandbox)

Use case: Happy path testing, webhook validation.

`full_failure`

❌ All domains fail

❌ No DB records created

🔔 prewarmup.order.failed webhook fired with error details

💾 No mailboxes created

Use case: Test error handling, retry logic, and user notifications.

`partial_failure`

⚠️ Few domain fails, remaining domains succeed

🔔 Both prewarmup.order.failed and prewarmup.order.success webhooks fire

💾 Successful domains provisioned

Use case: Test handling of mixed outcomes, cleanup logic, user communication for partial orders.

Webhook sequence:

prewarmup.order.failed → lists failed domain only

prewarmup.order.success → lists remaining domains

Webhook not arriving

Problem: Your webhook endpoint didn't receive the event.

Checklist:

Verify your webhook URL is configured in the partner dashboard

Check that your endpoint is publicly accessible (not localhost)

Confirm your endpoint returns HTTP 200–299 within 10 seconds

Check your server logs for incoming requests

Test with a webhook debugging tool like webhook.site

FAQ

Q: Can I use sandbox domains in production?
No. Sandbox domains exist only in test and will never resolve to real mailboxes.

Q: Are sandbox orders visible in my transaction history?
Yes. They appear as $0 DEBIT transactions, making your code indistinguishable between sandbox and production.

Q: Can I reorder the same sandbox domain?
Yes. Reset it first.

Q: Do DNS records get created in sandbox?
No. You don't need to manage any DNS for sandbox testing.

Q: What if my webhook handler crashes?
The order still succeeds in the database. You won't receive the webhook. Fix your handler and manually query the API or database to confirm order status.

Questions? Contact support@coldmailreseller.com or visit our integration docs.

Why use sandbox?#

How sandbox works#

What happens in our sandbox#

What gets skipped#

Data retention#

Sandbox domains & mailboxes#

Google Workspace domains#

Microsoft domains#

Endpoints#

Scenarios – Simulating order outcomes#

success (default)#

full_failure#

partial_failure#

Webhook not arriving#

FAQ#