Create Temp Email Inbox

Create disposable temporary email inboxes in bulk and poll them for inbound messages and OTP codes. Built for QA engineers, CI pipelines, and AI agents that need throwaway addresses for signup, magic-link, and transactional email testing. Each dataset row returns email, provider, session tokens, subject, textPreview, and optional otp.

Best fit for this Actor

• Choose this Actor when you already control a staging app and need a disposable inbox to receive verification mail.
• Designed for QA create + poll workflows with Guerrilla Mail primary and mail.tm failover (Powered by mail.tm).
• Start with mode: "createInbox" and count: 1, then continue with pollInbox using the returned session token.
• For disposable-domain detection on an existing address, then use Email Address Validator.
• For breach-history enrichment of an email, then use Email Breach Checker.

Workflow story

A CI job starts with createInbox, pastes the returned address into a staging password-reset form, then polls the same inbox for up to 60 seconds. When the message arrives, otp is filled and the test asserts the code. If the window is empty, the Actor ends with VALID_EMPTY with no message event charges — keep the token and poll again after the app sends mail.

Quick start input

{
  "mode": "createInbox",
  "provider": "auto",
  "count": 1,
  "extractOtp": true
}

Input reference

Field	Type	What it controls
mode	string	listDomains, createInbox, pollInbox, or createAndPoll
provider	string	auto (default), guerrilla, or mailtm
count	integer	Inboxes to create, 1–25. Prefill 1
pollDurationSecs	integer	Poll window 0–120 seconds
extractOtp	boolean	Parse 4–8 digit codes from subject/body
matchSubject / matchFrom	string	Optional filters
email + session secrets	string	Required for pollInbox

What data you receive

Each dataset item is an inbox, message, or domain row.

{
  "recordType": "inbox",
  "email": "example@guerrillamailblock.com",
  "provider": "guerrilla",
  "guerrillaSidToken": "session-token",
  "createdAt": "ISO-8601 timestamp",
  "mode": "createInbox",
  "outcome": "OK"
}

Field	Meaning
recordType	inbox, message, or domain
email	Disposable address
provider	guerrilla or mailtm
guerrillaSidToken / mailtmToken	Session credentials for later poll
from / subject / textPreview	Inbound message fields
otp	Extracted verification code when present

OUTPUT and RUN_SUMMARY hold outcome, itemsPushed, inboxesCreated, and messagesReceived. Download the dataset as JSON, CSV, Excel, or HTML.

Pricing (Pay per event + usage)

Pay per event with caller-paid platform usage. The live Pricing tab is the current source of truth.

Event	Price
Actor start	$0.00005
Inbox created	$0.003
Message received	$0.008

Worked example: create 3 inboxes ≈ $0.00005 + 3 × $0.003 = $0.00905 plus platform usage. Domain-list rows and empty polls skip charging inbox or message events.

Use through the API

curl -X POST "https://api.apify.com/v2/acts/khadinakbar~create-temp-email-inbox/runs" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"createInbox","provider":"auto","count":1}'

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('khadinakbar/create-temp-email-inbox').call({
  mode: 'createInbox',
  provider: 'auto',
  count: 1,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

On Apify MCP, call apify--create-temp-email-inbox.

Agent prompt card

Create one disposable email inbox for QA, return the address and session token with provenance fields, then poll for up to 60 seconds for a verification message and extract any OTP. Prefer VALID_EMPTY over fabricating messages when the window is quiet.

Best results

• Provide a short pollDurationSecs first, then extend if the staging app is slow.
• Start with provider: "auto" so Guerrilla → mail.tm failover covers outages.
• Confirm the staging app actually sent mail before repeating an empty poll.
• Keep count focused (1–5) for CI; schedule larger batches as separate runs.
• Validate session tokens from create rows before calling pollInbox.

Builder's note

I built this Actor around documented Guerrilla and mail.tm HTTP APIs after finding that temp-mail HTML UIs change too often for reliable QA automation. My goal was a multi-provider OTP catcher with honest empty-poll semantics, not another thin single-API wrap.

Responsible use

Responsible use

Use on systems you are authorized to test. Respect provider rate limits, applicable laws, and Apify Store policies. Guerrilla Mail is a trademark of its respective owners. This independent Actor is not affiliated with or endorsed by Guerrilla Mail. mail.tm is a trademark of its respective owners. Portions of this Actor are Powered by mail.tm. This Actor is not affiliated with or endorsed by mail.tm.