# DropMail

> Make disposable email inboxes that receive real mail, with DropMail. Create an inbox, use its address to sign up for something or to test the emails your own product sends, then wait for the email and read it, links included, or start a workflow whenever one arrives. Add more addresses to an inbox, and bring an address back later with its restore key.

App · 9 actions. Web page: https://docs.lodol.com/docs/integrations/dropmail

## Actions

### Add an address to an inbox

Give an inbox one more random email address, on a domain you choose or a random one. Mail to any of an inbox's addresses lands in the same inbox.

**Inputs**

- Inbox (`inbox_id`, text, required): The inbox to use: pick one that is open now, or use the Inbox ID from an earlier 'Create an inbox' step.
- Domain (`domain`, text): The part of the address after the @. Leave blank for a random one. DropMail picks the part before the @.
- Only permanent domains (`permanent_domain_only`, true/false): When the domain is left blank, turn on to draw only from domains DropMail keeps for good, for an address you may want back later. Some domains are retired on a set date. Default: `false`.

**Outputs**

- `address` (text): The email address. Mail sent to it arrives in the inbox.
- `address_id` (text): DropMail's ID for this address in this inbox.
- `domain` (text): The part of the address after the @.
- `inbox_id` (text): The inbox the address is in.
- `restore_key` (text): Keep this to get the address back after its inbox is deleted, with 'Restore an address'.

**Example output**

```json
{
  "address": "hopitytuzedyd4@maximail.fyi",
  "address_id": "QWRkcmVzczrrUpxZirhM4I15GpjbKLxQOmhvcGl0eXR1emVkeWQ0QG1heGltYWlsLmZ5aQ",
  "domain": "maximail.fyi",
  "inbox_id": "U2Vzc2lvbjrrUpxZirhM4I15GpjbKLxQ",
  "restore_key": "0403bf0f27074c35a607918008c9d8d15"
}
```

### Create an inbox

Make a new disposable inbox with a random email address that receives real mail straight away. Use it to sign up for something or catch a confirmation email, then read what arrives with 'Wait for an email' or 'List emails'. DropMail deletes the inbox 10 minutes after it was last used.

**Inputs**

- Domain (`domain`, text): The part of the address after the @. Leave blank for a random one. DropMail picks the part before the @.
- Only permanent domains (`permanent_domain_only`, true/false): When the domain is left blank, turn on to draw only from domains DropMail keeps for good, for an address you may want back later. Some domains are retired on a set date. Default: `false`.

**Outputs**

- `address` (text): The inbox's newest address.
- `address_id` (text): DropMail's ID for this address in this inbox.
- `addresses` (list): Every address that delivers to this inbox, newest first.
- `domain` (text): The part of the address after the @.
- `download_all_url` (text): A link that downloads every email in the inbox as a .zip.
- `email_count` (number): How many emails the inbox has received.
- `expires_at` (text): When DropMail deletes the inbox and its emails, unless it is used again before then (ISO 8601).
- `inbox_id` (text): The inbox's ID, for the other DropMail steps.
- `restore_key` (text): Keep this to get the address back after its inbox is deleted, with 'Restore an address'.

**Example output**

```json
{
  "address": "alddyfewbgtoaj@dropmail.me",
  "address_id": "QWRkcmVzczrrUpxZirhM4I15GpjbKLxQOmFsZGR5ZmV3Ymd0b2FqQGRyb3BtYWlsLm1l",
  "addresses": [
    {
      "address": "alddyfewbgtoaj@dropmail.me",
      "address_id": "QWRkcmVzczrrUpxZirhM4I15GpjbKLxQOmFsZGR5ZmV3Ymd0b2FqQGRyb3BtYWlsLm1l",
      "domain": "dropmail.me",
      "restore_key": "02c2105117f701252816d561dfdc3e9a9"
    }
  ],
  "domain": "dropmail.me",
  "download_all_url": "https://dropmail.me/download/all_archive/gql:free-api-37f9f7ad-207c-4e94-ab8d-a2ee24836f70:eb529c59-8ab8-4ce0-8d79-1a98db28bc50",
  "email_count": 0,
  "expires_at": "2026-10-19T22:55:43+00:00",
  "inbox_id": "U2Vzc2lvbjrrUpxZirhM4I15GpjbKLxQ",
  "restore_key": "02c2105117f701252816d561dfdc3e9a9"
}
```

### Get an inbox

Check an inbox: its addresses with their restore keys, how many emails it has received and when it will be deleted. Checking counts as use, so it also keeps the inbox open.

**Inputs**

- Inbox (`inbox_id`, text, required): The inbox to use: pick one that is open now, or use the Inbox ID from an earlier 'Create an inbox' step.

**Outputs**

- `address` (text): The inbox's newest address.
- `addresses` (list): Every address that delivers to this inbox, newest first.
- `download_all_url` (text): A link that downloads every email in the inbox as a .zip.
- `email_count` (number): How many emails the inbox has received.
- `expires_at` (text): When DropMail deletes the inbox and its emails, unless it is used again before then (ISO 8601).
- `inbox_id` (text): The inbox's ID, for the other DropMail steps.

**Example output**

```json
{
  "address": "hopitytuzedyd4@maximail.fyi",
  "addresses": [
    {
      "address": "hopitytuzedyd4@maximail.fyi",
      "address_id": "QWRkcmVzczrrUpxZirhM4I15GpjbKLxQOmhvcGl0eXR1emVkeWQ0QG1heGltYWlsLmZ5aQ",
      "domain": "maximail.fyi",
      "restore_key": "0403bf0f27074c35a607918008c9d8d15"
    },
    {
      "address": "alddyfewbgtoaj@dropmail.me",
      "address_id": "QWRkcmVzczrrUpxZirhM4I15GpjbKLxQOmFsZGR5ZmV3Ymd0b2FqQGRyb3BtYWlsLm1l",
      "domain": "dropmail.me",
      "restore_key": "02c2105117f701252816d561dfdc3e9a9"
    }
  ],
  "download_all_url": "https://dropmail.me/download/all_archive/gql:free-api-37f9f7ad-207c-4e94-ab8d-a2ee24836f70:eb529c59-8ab8-4ce0-8d79-1a98db28bc50",
  "email_count": 1,
  "expires_at": "2026-10-19T22:55:43+00:00",
  "inbox_id": "U2Vzc2lvbjrrUpxZirhM4I15GpjbKLxQ"
}
```

### List domains

Get the domains (the part after the @) new addresses can use, and which of them DropMail will retire, and when.

**Inputs**

- Only permanent domains (`permanent_only`, true/false): Turn on to leave out domains DropMail will retire. Default: `false`.

**Outputs**

- `count` (number): How many domains there are.
- `domains` (list): The domains.

**Example output**

```json
{
  "count": 3,
  "domains": [
    {
      "domain_id": "RG9tYWluOjE",
      "expires_at": "",
      "introduced_at": "2013-05-10T10:00:00.000+00:00",
      "name": "dropmail.me",
      "permanent": true
    },
    {
      "domain_id": "RG9tYWluOjI",
      "expires_at": "",
      "introduced_at": "2013-11-13T11:00:00.000+00:00",
      "name": "10mail.org",
      "permanent": true
    },
    {
      "domain_id": "RG9tYWluOjg4",
      "expires_at": "2027-03-10T00:00:00+00:00",
      "introduced_at": "2026-03-12T21:05:55.237+00:00",
      "name": "mail2me.co",
      "permanent": false
    }
  ]
}
```

### List emails

Get the emails in an inbox, newest first and each in full: sender, subject, text, links and attachments. Up to the newest 100 are listed.

**Inputs**

- Inbox (`inbox_id`, text, required): The inbox to use: pick one that is open now, or use the Inbox ID from an earlier 'Create an inbox' step.
- Only emails after (`after_email_id`, text): An Email ID from an earlier step: only emails that arrived after it are listed. Leave blank for all.

**Outputs**

- `count` (number): How many emails are listed.
- `email_count` (number): How many emails the inbox has received.
- `emails` (list): The emails, newest first.
- `inbox_id` (text): The inbox.
- `latest_email_id` (text): The newest listed email's ID, or empty when none are listed.

**Example output**

```json
{
  "count": 1,
  "email_count": 1,
  "emails": [
    {
      "attachments": [],
      "download_url": "https://dropmail.me/download/mail/gql:free-api-37f9f7ad-207c-4e94-ab8d-a2ee24836f70:db9c75aa-18e4-4e50-b6d2-ccc1e392d4ac/20261019qbsgwsen49jejt9cppafwbsr4kqng5yy",
      "email_id": "TWFpbDrbnHWqGOROULbSzMHjktSsOjIwMjYxMDE5cWJzZ3dzZW40OWplanQ5Y3BwYWZ3YnNyNGtxbmc1eXk",
      "from": "FormSubmit <submissions@formsubmit.co>",
      "from_address": "submissions@formsubmit.co",
      "html": "<!doctype html>\r\n<html lang=\"en\">\r\n<head>\r\n    <meta charset=\"UTF-8\">\r\n    <title>Easy form endpoints for your HTML forms</title>",
      "links": [
        "https://lodol.com/",
        "https://formsubmit.co/confirm/bc8985fa29d342a6a4e18fde52e9dabe"
      ],
      "received_at": "2026-10-19T22:42:45+00:00",
      "size_bytes": 2568,
      "subject": "Action Required: Activate FormSubmit on https://lodol.com/",
      "text": "Thank you for using FormSubmit! You're only one step away from making forms on https://lodol.com/\r\n functional. Click 'Activate Form' to begin receiving submissions from this form.\n [ACTIVATE FORM](https://formsubmit.co/confirm/bc8985fa29d342a6a4e18fde52e9dabe)\n",
      "to": "fyginojyh1m3@maximail.vip"
    }
  ],
  "inbox_id": "U2Vzc2lvbjrrUpxZirhM4I15GpjbKLxQ",
  "latest_email_id": "TWFpbDrbnHWqGOROULbSzMHjktSsOjIwMjYxMDE5cWJzZ3dzZW40OWplanQ5Y3BwYWZ3YnNyNGtxbmc1eXk"
}
```

### List inboxes

Get every inbox this connection has open, with its addresses and email count, including ones whose Inbox ID was not kept.

**Inputs**: None.

**Outputs**

- `count` (number): How many inboxes are open.
- `inboxes` (list): The open inboxes.

**Example output**

```json
{
  "count": 1,
  "inboxes": [
    {
      "address": "alddyfewbgtoaj@dropmail.me",
      "addresses": [
        {
          "address": "alddyfewbgtoaj@dropmail.me",
          "address_id": "QWRkcmVzczrrUpxZirhM4I15GpjbKLxQOmFsZGR5ZmV3Ymd0b2FqQGRyb3BtYWlsLm1l",
          "domain": "dropmail.me",
          "restore_key": "02c2105117f701252816d561dfdc3e9a9"
        }
      ],
      "download_all_url": "https://dropmail.me/download/all_archive/gql:free-api-37f9f7ad-207c-4e94-ab8d-a2ee24836f70:eb529c59-8ab8-4ce0-8d79-1a98db28bc50",
      "email_count": 0,
      "expires_at": "2026-10-19T22:55:43+00:00",
      "inbox_id": "U2Vzc2lvbjrrUpxZirhM4I15GpjbKLxQ"
    }
  ]
}
```

### Remove an address from an inbox

Stop one of an inbox's addresses receiving mail. Emails it already received stay in the inbox. Keep the restore key it returns to bring the address back later.

**Inputs**

- Inbox (`inbox_id`, text, required): The inbox to use: pick one that is open now, or use the Inbox ID from an earlier 'Create an inbox' step.
- Address (`address`, text, required): The address to remove, one of the inbox's own.

**Outputs**

- `address` (text): The address that was removed.
- `inbox_id` (text): The inbox.
- `removed` (true/false): Whether DropMail removed it.
- `restore_key` (text): Keep this to get the address back after its inbox is deleted, with 'Restore an address'.

**Example output**

```json
{
  "address": "hopitytuzedyd4@maximail.fyi",
  "inbox_id": "U2Vzc2lvbjrrUpxZirhM4I15GpjbKLxQ",
  "removed": true,
  "restore_key": "0403bf0f27074c35a607918008c9d8d15"
}
```

### Restore an address

Bring back an address that was removed, or whose inbox was deleted, using the restore key DropMail gave with it. It receives mail again in the inbox you choose. Emails from before are not brought back, and the address gets a new restore key.

**Inputs**

- Inbox (`inbox_id`, text, required): The inbox to use: pick one that is open now, or use the Inbox ID from an earlier 'Create an inbox' step.
- Address (`address`, text, required): The address to bring back.
- Restore key (`restore_key`, text, required): The restore key that came with the address, from the step that created, added or removed it.

**Outputs**

- `address` (text): The email address. Mail sent to it arrives in the inbox.
- `address_id` (text): DropMail's ID for this address in this inbox.
- `domain` (text): The part of the address after the @.
- `inbox_id` (text): The inbox the address is in.
- `restore_key` (text): Keep this to get the address back after its inbox is deleted, with 'Restore an address'.

**Example output**

```json
{
  "address": "hopitytuzedyd4@maximail.fyi",
  "address_id": "QWRkcmVzczrrUpxZirhM4I15GpjbKLxQOmhvcGl0eXR1emVkeWQ0QG1heGltYWlsLmZ5aQ",
  "domain": "maximail.fyi",
  "inbox_id": "U2Vzc2lvbjrrUpxZirhM4I15GpjbKLxQ",
  "restore_key": "041737960976bb070725ad9544c3b0d40"
}
```

### Wait for an email

Pause until an email is in the inbox, then give it in full, links included. Put it after the step that signs up or sends the email. If nothing arrives in time, the step finishes with Received set to no instead of failing.

**Inputs**

- Inbox (`inbox_id`, text, required): The inbox to use: pick one that is open now, or use the Inbox ID from an earlier 'Create an inbox' step.
- Wait up to (seconds) (`timeout_seconds`, number): How long to wait before giving up, between 5 and 180 seconds. From 5 to 180. Default: `60`.
- Only new emails (`only_new`, true/false): Turn on to ignore emails already in the inbox and wait for the next one. Off, the newest email already there counts, so a fast sender is never missed. Default: `false`.

**Outputs**

- `attachments` (list): Files attached to the email.
- `download_url` (text): A link that downloads the original email (.eml).
- `email_id` (text): The email's ID.
- `from` (text): The sender as the email shows it, name and address.
- `from_address` (text): The sender's address.
- `html` (text): The formatted version of the email, if it has one.
- `inbox_id` (text): The inbox that was watched.
- `links` (list): Every web link in the email's text, in order.
- `received` (true/false): Whether an email arrived in time. When no, the email fields are empty.
- `received_at` (text): When the email arrived (ISO 8601).
- `size_bytes` (number): The email's size in bytes.
- `subject` (text): The subject line.
- `text` (text): The email's text. For an email with only a formatted version, the text DropMail read out of it.
- `to` (text): The address the email was sent to.
- `waited_seconds` (number): How long the step waited.

**Example output**

```json
{
  "attachments": [],
  "download_url": "https://dropmail.me/download/mail/gql:free-api-37f9f7ad-207c-4e94-ab8d-a2ee24836f70:db9c75aa-18e4-4e50-b6d2-ccc1e392d4ac/20261019qbsgwsen49jejt9cppafwbsr4kqng5yy",
  "email_id": "TWFpbDrbnHWqGOROULbSzMHjktSsOjIwMjYxMDE5cWJzZ3dzZW40OWplanQ5Y3BwYWZ3YnNyNGtxbmc1eXk",
  "from": "FormSubmit <submissions@formsubmit.co>",
  "from_address": "submissions@formsubmit.co",
  "html": "<!doctype html>\r\n<html lang=\"en\">\r\n<head>\r\n    <meta charset=\"UTF-8\">\r\n    <title>Easy form endpoints for your HTML forms</title>",
  "inbox_id": "U2Vzc2lvbjrrUpxZirhM4I15GpjbKLxQ",
  "links": [
    "https://lodol.com/",
    "https://formsubmit.co/confirm/bc8985fa29d342a6a4e18fde52e9dabe"
  ],
  "received": true,
  "received_at": "2026-10-19T22:42:45+00:00",
  "size_bytes": 2568,
  "subject": "Action Required: Activate FormSubmit on https://lodol.com/",
  "text": "Thank you for using FormSubmit! You're only one step away from making forms on https://lodol.com/\r\n functional. Click 'Activate Form' to begin receiving submissions from this form.\n [ACTIVATE FORM](https://formsubmit.co/confirm/bc8985fa29d342a6a4e18fde52e9dabe)\n",
  "to": "fyginojyh1m3@maximail.vip",
  "waited_seconds": 6
}
```
