# DropInbox - Disposable Emails on Gmail, Outlook & iCloud etc (`dev00/dropinbox-disposable-emails-api`) Actor

Generate disposable email aliases on real providers (Gmail, Outlook, Hotmail, iCloud etc). Activate and receive real emails instantly. No signup, no tokens, no cookies.

- **URL**: https://apify.com/dev00/dropinbox-disposable-emails-api.md
- **Developed by:** [dev00](https://apify.com/dev00) (community)
- **Categories:** Automation, Lead generation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$5.00 / 1,000 dropinbox api queries

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## DropInbox — Instant Disposable Email on Gmail, Outlook & iCloud

Generate **real disposable email aliases** on Gmail, Outlook, Hotmail, and iCloud — and receive actual emails in seconds. No signup, no tokens, no cookies. Just 3 simple API calls.

---

### ✨ Key Features

* 📧 **Real Provider Aliases** — Generate on Gmail, Outlook, Hotmail, iCloud (not blocked throwaway domains)
* 🛡️ **Bypass Anti-Spam & Domain Blocklists** — High deliverability rate because domain names are 100% legitimate
* ⚡ **Instant Activation** — Alias starts receiving emails immediately after activation
* 🔐 **Zero Authentication Overhead** — No cookies, no API tokens, no complex session state to manage
* 🏗️ **Stateless API** — Generate → Activate → Read. Simple 3-step automation pipeline
* 🚀 **Sub-second Latency** — Powered by global edge computing infrastructure

---

### 📥 Input Parameters

| Parameter | Type | Required | Default | Description |
| :--- | :--- | :--- | :--- | :--- |
| `endpoint` | String | Yes | `generate-email` | Select action: `generate-email`, `use-email`, or `check-emails` |
| `provider` | String | No | `gmail` | Provider dropdown: `gmail`, `outlook`, `hotmail`, `icloud`, `temp` |
| `email` | String | Conditional | — | Full email alias (required for `use-email` and `check-emails`) |

#### Input Example (JSON):
```json
{
  "endpoint": "generate-email",
  "provider": "gmail"
}
````

***

### 📤 Output Format & Response Examples

Output data is pushed to the default Dataset and stored as JSON in the Key-Value store under key `OUTPUT`.

#### 1. Generate Email Response (`endpoint: "generate-email"`)

```json
{
  "success": true,
  "email": "bushcalehrunk7o+w28pz@gmail.com",
  "provider": "gmail"
}
```

#### 2. Activate Email Response (`endpoint: "use-email"`)

```json
{
  "success": true,
  "message": "Inbox activated. You can now receive emails."
}
```

#### 3. Check Emails Response (`endpoint: "check-emails"`)

```json
{
  "success": true,
  "total": 2,
  "emails": [
    {
      "email_address": "bushcalehrunk7o+w28pz@gmail.com",
      "sender": "service@example.com",
      "subject": "Your verification code: 849201",
      "timestamp": "2026-07-27T02:46:42",
      "uuid": "666cbc45758945198f9bd450425e7276"
    },
    {
      "email_address": "bushcalehrunk7o+w28pz@gmail.com",
      "sender": "welcome@app.com",
      "subject": "Welcome to the platform!",
      "timestamp": "2026-07-27T02:45:10",
      "uuid": "777dbc45758945198f9bd450425e7277"
    }
  ]
}
```

***

### 💡 How To Use — 3-Step Workflow

1. **Generate** → Run with `endpoint: "generate-email"` and `provider: "gmail"` → Copy the returned email alias
2. **Activate** → Run with `endpoint: "use-email"` and `email: "YOUR_ALIAS"` → Inbox is now live
3. **Read** → Run with `endpoint: "check-emails"` and `email: "YOUR_ALIAS"` → View received messages

***

### 🙋 Frequently Asked Questions (FAQ)

**Q: Do I need to manage session tokens or cookies?**\
A: No! DropInbox handles signature creation and timestamp headers server-side. The actor is completely stateless for your scraping and automation workflows.

**Q: Why are Gmail / Outlook / iCloud aliases better than regular temp mail?**\
A: Most websites actively block disposable domain extensions (`@tempmail.com`, `@mailinator.com`). Because DropInbox uses real Gmail, Outlook, Hotmail, and iCloud domains, sign-up forms treat them as normal user accounts.

**Q: Is calling `use-email` mandatory before `check-emails`?**\
A: Yes. `use-email` registers the inbox listener so incoming messages are caught and stored for retrieval.

**Q: Can I send emails using this actor?**\
A: No. This tool is designed strictly for receiving verification codes, OTPs, and sign-up activation links.

***

### 🎯 Use Cases

- 🧪 **QA & Automated Testing** — Generate a unique email address per test execution
- 🔐 **OTP & Verification Code Extraction** — Automatically capture OTP codes in Apify datasets
- 🛡️ **Privacy & Account Creation** — Create accounts without exposing personal emails
- 📊 **Lead Gen Form Audits** — Test form delivery across Gmail, Outlook, Hotmail, and iCloud
- 🤖 **End-to-End Scraping Pipelines** — Chain with web scrapers for automated account verification

***

### 🔍 Keywords & Tags

`temp email api`, `disposable email`, `gmail temp email`, `outlook temp email`, `icloud disposable email`, `email generator api`, `temporary email address`, `email verification api`, `otp catcher`, `burner email api`

# Actor input Schema

## `endpoint` (type: `string`):

Select the action to perform.

## `provider` (type: `string`):

The email provider for alias generation. Only used with /generate-email.

## `email` (type: `string`):

The full email alias (e.g., 'user+123@gmail.com'). Required for /use-email and /check-emails.

## Actor input object example

```json
{
  "endpoint": "generate-email",
  "provider": "gmail",
  "email": "ecawegivezow10+m7w613@gmail.com"
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `keyValueStoreResult` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "endpoint": "generate-email",
    "provider": "gmail",
    "email": "ecawegivezow10+m7w613@gmail.com"
};

// Run the Actor and wait for it to finish
const run = await client.actor("dev00/dropinbox-disposable-emails-api").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "endpoint": "generate-email",
    "provider": "gmail",
    "email": "ecawegivezow10+m7w613@gmail.com",
}

# Run the Actor and wait for it to finish
run = client.actor("dev00/dropinbox-disposable-emails-api").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "endpoint": "generate-email",
  "provider": "gmail",
  "email": "ecawegivezow10+m7w613@gmail.com"
}' |
apify call dev00/dropinbox-disposable-emails-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=dev00/dropinbox-disposable-emails-api",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "DropInbox - Disposable Emails on Gmail, Outlook & iCloud etc",
        "description": "Generate disposable email aliases on real providers (Gmail, Outlook, Hotmail, iCloud etc). Activate and receive real emails instantly. No signup, no tokens, no cookies.",
        "version": "1.0",
        "x-build-id": "pR2gYxaSld3kSKRa4"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/dev00~dropinbox-disposable-emails-api/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-dev00-dropinbox-disposable-emails-api",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/dev00~dropinbox-disposable-emails-api/runs": {
            "post": {
                "operationId": "runs-sync-dev00-dropinbox-disposable-emails-api",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/dev00~dropinbox-disposable-emails-api/run-sync": {
            "post": {
                "operationId": "run-sync-dev00-dropinbox-disposable-emails-api",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "endpoint"
                ],
                "properties": {
                    "endpoint": {
                        "title": "API Endpoint",
                        "enum": [
                            "generate-email",
                            "use-email",
                            "check-emails"
                        ],
                        "type": "string",
                        "description": "Select the action to perform.",
                        "default": "generate-email"
                    },
                    "provider": {
                        "title": "Email Provider",
                        "enum": [
                            "gmail",
                            "outlook",
                            "hotmail",
                            "icloud",
                            "temp"
                        ],
                        "type": "string",
                        "description": "The email provider for alias generation. Only used with /generate-email.",
                        "default": "gmail"
                    },
                    "email": {
                        "title": "Email Address",
                        "type": "string",
                        "description": "The full email alias (e.g., 'user+123@gmail.com'). Required for /use-email and /check-emails."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```