Skip to main content

Pattern

Plain java.net.http.HttpClient (Java 11+) plus any JSON library. No SDK, no API key.
POST /api/new_address is Turnstile-protected on the public instance. Pre-create addresses in the web UI and reuse the JWT, or self-host with Turnstile disabled. See API Overview.

Helper: TempInbox.java

TempInbox.java

Example: JUnit 5 + Selenium

SignupTest.java

Tips

  • One inbox per test — safe with JUnit parallel execution
  • 2–3s poll interval, 60s timeout for external SMTP in CI — list responses cached up to 60s at offset=0
  • metadata is a JSON string — parse it before reading subject