Skip to main content
The hosted TempInbox service has no supported public automation API. These implementation examples are for an instance you operate and must be checked against its deployed version, authentication, inbound mail routing, and rate limits. Do not export hosted browser access tokens for CI. For hosted manual use, see QA workflows.
For automation, configure and use your own instance. Hosted browser access tokens are not a supported integration credential.

Create Address

POST /api/new_address Creates a new temporary inbox. Returns an address-scoped JWT. Cookie and session behavior depends on the deployed version; the current address-creation path does not create a server-side session.

Turnstile Requirement

This endpoint is protected by Cloudflare Turnstile on the public instance. Raw API calls without a valid cf_token will fail. For self-hosted automation: obtain an address token from your own configured deployment. Hosted browser credentials are not a supported integration; see Authentication. For self-hosted instances with Turnstile disabled:
Response

Custom Name

To request a specific local part (before @):
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.
Response

Delete Address

DELETE /api/delete_address Permanently deletes the address and all its emails. Irreversible.
Response
Rate limit: Per IP. Avoid calling in tight loops.