API · public testing

Create anonymous test inbox

POST /api/v2/public/inboxes

Authorization

No authentication or signup required. Creation is rate-limited by network.

Contract

Required Idempotency-Key: 16–128 letters, numbers, underscore or hyphen. No request body required. Returns HTTP 201 with address, token and poll_after_seconds.

HTTP request

Use from an agent, test runner or HTTP client. No CLI required.

Example

curl -X POST 'https://inboxit.wtf/api/v2/public/inboxes' -H 'Idempotency-Key: signup-test-unique-001'

Limits and errors

Receive-only: 24 hours from creation, up to 100 incoming emails and 10 MB per inbox. Up to three creations per network per UTC day and three active inboxes; browser/API share limits. Service-wide capacity also applies. Never put the secret token in URLs, logs or public code. 400 invalid parameters; 401 missing/invalid token; 404 unavailable resource; 410 expired resource where applicable; 429 rate/capacity limit (respect Retry-After); 503 unavailable. The complete walkthrough is under Guides → Email testing without signup.