Step-by-step guides for integrating TempMail with popular frameworks, testing tools, and automation platforms.
Use the official npm SDK or fetch directly. Full async/await support with streaming inbox events.
pip install tempmail. Sync and asyncio clients included. Works with pytest, Playwright, and Selenium.
composer require tempmail/sdk. PSR-18 HTTP client abstraction. Laravel and Symfony examples included.
End-to-end testing guides for sign-up flows. Generate an address, complete registration, verify in one script.
CI/CD pipeline recipes — generate test inboxes, perform email verification, and clean up automatically.
No-code integration guides for automation platforms. Trigger flows when a new email arrives in your inbox.
import requests, time from playwright.sync_api import sync_playwright KEY = "YOUR_API_KEY" BASE = "https://api.tempmail.io/v1" # 1. Get disposable address email = requests.get(f"{BASE}/generate_email.php?key={KEY}").json()["email"] # 2. Sign up on any site with sync_playwright() as p: browser = p.chromium.launch() page = browser.new_page() page.goto("https://example.com/signup") page.fill('[name=email]', email) page.fill('[name=password]', "TestPass123!") page.click('[type=submit]') # 3. Wait for verification email for _ in range(12): time.sleep(5) msgs = requests.get(f"{BASE}/inbox.php?key={KEY}&email={email}").json() if msgs: break # 4. Click verification link msg = requests.get(f"{BASE}/read.php?key={KEY}&email={email}&id={msgs[0]['id']}").json() page.goto(msg["confirmation_link"]) browser.close()
name: E2E Signup Test on: [push] jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Generate TempMail address id: tempmail run: | EMAIL=$(curl -s "https://api.tempmail.io/v1/generate_email.php?key=${{ secrets.TEMPMAIL_KEY }}" | jq -r .email) echo "email=$EMAIL" >> $GITHUB_OUTPUT - name: Run Playwright tests env: TEST_EMAIL: ${{ steps.tempmail.outputs.email }} TEMPMAIL_KEY: ${{ secrets.TEMPMAIL_KEY }} run: npx playwright test --project=chromium
Full API docs, SDKs, and code examples — everything you need to get started in minutes.
View API Reference