Skip to main content
POST
/
sandbox
/
create
Create a sandbox
curl --request POST \
  --url https://api.useplinth.com/sandbox/create
{
  "object": "sandbox",
  "tenant_id": "ten_01JXYZ...",
  "api_key": "sk_test_a1b2c3d4e5f6...",
  "expires_at": "2026-06-19T12:00:00Z",
  "plans": [
    {
      "id": "pln_01JAA...",
      "name": "Starter",
      "amount_minor": "200000",
      "currency": "NGN",
      "interval": "month"
    },
    {
      "id": "pln_01JAB...",
      "name": "Pro",
      "amount_minor": "500000",
      "currency": "NGN",
      "interval": "month"
    },
    {
      "id": "pln_01JAC...",
      "name": "Max",
      "amount_minor": "1200000",
      "currency": "NGN",
      "interval": "month"
    }
  ],
  "customer": {
    "id": "cus_01JAD...",
    "name": "Sandbox Customer",
    "email": "customer@sandbox.ng"
  }
}

Response

201 - application/json

Sandbox created

object
enum<string>
Available options:
sandbox
tenant_id
string
Example:

"ten_01JXYZ..."

api_key
string

Your private API key. Store it — it cannot be retrieved again.

Example:

"sk_test_a1b2c3d4e5f6..."

expires_at
string<date-time>

Sandbox tenants are automatically deleted after 24 hours.

plans
object[]
customer
object