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 validcf_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:
Custom Name
To request a specific local part (before@):
Get Address Info
GET /api/settings
Returns the address for the current JWT. Useful for verifying auth.
Delete Address
DELETE /api/delete_address
Permanently deletes the address and all its emails. Irreversible.