Quickstart

1. Create an API key

Sign up at ghostbox.dev/signup and create a new API key from the dashboard. Your key will look like this:

sandbox_test_abc123def456ghi789jkl012mno345pqr678

Keys start with sandbox_test_ so they are obviously non-production. Store your key somewhere safe -- it is shown only once.

2. Make your first request

Point any HTTP client at the sandbox. The base URL pattern is ghostbox.dev/sandbox/<service>.

# Create a Stripe customer via the sandbox
curl -X POST https://ghostbox.dev/sandbox/stripe/v1/customers \
  -H "Authorization: Bearer sandbox_test_abc123..." \
  -d "email=test@example.com" \
  -d "name=Jane Doe"

# Response: full Stripe customer object
# {
#   "id": "cus_abc123...",
#   "object": "customer",
#   "email": "test@example.com",
#   "name": "Jane Doe",
#   "created": 1711234567,
#   ...
# }

3. Use with official SDKs

Most API SDKs let you override the base URL. Keep using the official client libraries -- just point them at Ghostbox.

import Stripe from 'stripe';

const stripe = new Stripe(process.env.SANDBOX_KEY!, {
  host: 'ghostbox.dev/sandbox/stripe',
});

// Works exactly like the real Stripe SDK
const customer = await stripe.customers.create({
  email: 'test@example.com',
});

console.log(customer.id); // "cus_abc123..."

import resend

resend.api_key = "sandbox_test_abc123..."
resend.api_url = "https://ghostbox.dev/sandbox/resend"

email = resend.Emails.send({
    "from": "test@example.com",
    "to": "user@example.com",
    "subject": "Hello from Ghostbox",
    "html": "<p>This is a test</p>"
})

See the SDK Integration page for all supported SDKs and languages.

Available services

Each sandbox implements the service's real API format, including authentication, pagination, and error shapes.