TempMailGrab Integrations

Use TempMailGrab as a manual disposable inbox, or plug it into a developer workflow. This hub connects every integration path that helps teams test signup, OTP, password reset, and email verification flows.

Developer integration map

IntegrationBest forCanonical guide
OpenAPI / PostmanExploring endpoints and sharing API collections.Postman import guide
PlaywrightBrowser tests that create accounts and verify OTPs.Playwright API guide
CypressEnd-to-end specs with polling and CI secrets.Cypress API guide
WebhooksPush-based email delivery instead of polling.API docs
Private domainsTeam-owned disposable inbox domains for QA.Private domains
JavaScript SDKTyped inboxes, OTP waiters, retries, and fixtures.SDK section

Recommended CI pattern

  1. Create a TempMailGrab API key from the dashboard.
  2. Store it as a CI secret named TMG_API_KEY.
  3. Create one inbox per test or per parallel worker.
  4. Submit the generated address inside the signup or reset flow.
  5. Read extracted_otp or extracted_links from the API response.
  6. Delete the inbox in teardown when tests generate heavy mail or attachments.

Manual workflow integrations

Last verified: . Integration examples are intentionally narrow: one inbox per test, structured OTP fields, and clear teardown behavior.

Frequently Asked Questions

What is the best TempMailGrab integration for developers?

Start with the OpenAPI spec or Postman import guide, then use the Playwright or Cypress guide if your workflow is browser-based.

Should tests share one temporary inbox?

No. Create one inbox per test or per parallel worker so OTPs and verification links do not cross between runs.

Can webhooks replace polling?

Yes. Register a webhook to receive parsed message payloads, including extracted OTP and links, when mail arrives.