Integrations

Connect TempMail to anything.

Step-by-step guides for integrating TempMail with popular frameworks, testing tools, and automation platforms.

Built for every workflow.
JavaScript / Node.js

Use the official npm SDK or fetch directly. Full async/await support with streaming inbox events.

Python

pip install tempmail. Sync and asyncio clients included. Works with pytest, Playwright, and Selenium.

PHP

composer require tempmail/sdk. PSR-18 HTTP client abstraction. Laravel and Symfony examples included.

Playwright / Cypress

End-to-end testing guides for sign-up flows. Generate an address, complete registration, verify in one script.

GitHub Actions

CI/CD pipeline recipes — generate test inboxes, perform email verification, and clean up automatically.

Zapier / Make

No-code integration guides for automation platforms. Trigger flows when a new email arrives in your inbox.

Test a sign-up flow automatically.
Python + Playwright
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()
CI/CD email verification.
YAML — .github/workflows/e2e.yml
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
Store your TempMail API key as a GitHub secret. Never commit API keys to source control.

Ready to integrate?

Full API docs, SDKs, and code examples — everything you need to get started in minutes.

View API Reference