Addresses

POST /api/new_address requires Cloudflare Turnstile when enabled on the server. For automation, extract a JWT from the browser instead of calling this endpoint directly. See Authentication for details.

Create Address

POST /api/new_address Creates a new temporary inbox. Returns a JWT and sets jwt + session_id cookies.

Turnstile Requirement

This endpoint is protected by Cloudflare Turnstile on the public instance. Raw API calls without a valid cf_token will fail. For automation: Use a JWT extracted from the browser UI instead. See Authentication → API automation. For self-hosted instances with Turnstile disabled:

curl -X POST https://your-instance.com/api/new_address \
  -H "Content-Type: application/json" \
  -d '{}'

const res = await fetch('https://your-instance.com/api/new_address', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({}),
});
const { address, jwt } = await res.json();

import requests
r = requests.post('https://your-instance.com/api/new_address', json={})
address = r.json()['address']
jwt = r.json()['jwt']

Response

{
  "address": "[email protected]",
  "jwt": "eyJhbGciOiJIUzI1NiJ9..."
}

Custom Name

To request a specific local part (before @):

{ "name": "mytest", "domain": "tempinbox.dev" }

Custom names may be rejected if they are on a blocklist or the server has disabled custom names. Always handle errors and fall back to random generation.

Get Address Info

GET /api/settings Returns the address for the current JWT. Useful for verifying auth.

curl "https://tempinbox.dev/api/settings" \
  -H "Authorization: Bearer <jwt>"

Response

{ "address": "[email protected]" }

Delete Address

DELETE /api/delete_address Permanently deletes the address and all its emails. Irreversible.

curl -X DELETE "https://tempinbox.dev/api/delete_address" \
  -H "Authorization: Bearer <jwt>"

Response

{ "success": true }

Rate limit: Per IP. Avoid calling in tight loops.

Get Started

API Reference

API Playground

Integration Guides

Comparisons

Policies

Create Address

Turnstile Requirement

Custom Name

Get Address Info

Delete Address

​Create Address

​Turnstile Requirement

​Custom Name

​Get Address Info

​Delete Address

Create Address

Turnstile Requirement

Custom Name

Get Address Info

Delete Address