discovery

Create a bounded 24-hour sandbox Form without an account

Requires a canonical UUIDv4 Idempotency-Key. Creates an inert sandbox Form that can accept at most five test Submissions and cannot create Destinations, Routes, Deliveries, Events or outbound traffic.

post/v1/public/sandboxes

Request

  • Base URL: https://postbag.dev
  • URL: https://postbag.dev/v1/public/sandboxes
  • Auth: none required

Headers

idempotency-keystring required

Canonical lowercase UUIDv4 generated with a CSPRNG.

Request body

namestring required
originstring uri

The site origin allowed to submit, canonicalized before storage.

claim_emailstring email

Optional verified-email binding. Include only when the user explicitly supplied it.

Response

created or idempotently replayed

sandbox_tokenstring required

Shown only in this response. Treat it as a secret.

claim_urlstring required

Example response

{
  "sandbox": {
    "id": "fm_8f3kq2",
    "expires_at": "2026-08-21T09:00:00.000Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.