mail.tm

Create free, throwaway email inboxes with mail.tm and read what arrives: test a sign-up flow end to end, catch a verification code or link, then delete the inbox. No account or API key is required.

Actions

Action	What it does
Create inbox	Create a new throwaway email inbox and get its address and password.
Delete email	Delete one email from an inbox.
Delete inbox	Delete an inbox and every email in it.
Get email	Read one email in full: the text (made from the HTML when the email has no text version), the HTML, every link, the link to click (verify, confirm, sign in...), any verification code and the names of its attachments.
Get inbox	Check an inbox still works and see how many emails it holds and how much of its storage they use.
Get raw email	Get an email exactly as it was received, with every header read out (From, Reply-To, Message-ID, DKIM and the rest).
List emails	List the emails in an inbox, newest first: sender, subject, a short preview and whether each has been read.
Mark email as read or unread	Mark an email read, or unread so 'Wait for an email' and 'List emails' with 'Unread only' pick it up again.
Wait for an email	Wait for a new email to arrive in an inbox, up to two minutes, then read it: the text, its links, the link to click (verify, confirm, sign in...) and any verification code.

Create a new throwaway email inbox and get its address and password. Use the address wherever an email should go, such as a sign-up form, then read what arrives with 'Wait for an email'. The other mail.tm steps take this address and password.

Inputs

Nameusernametext: The part before the @. Leave empty for a random one, which is never already taken.
Domaindomaintext: The part after the @. Leave empty to use the first one mail.tm offers.
Passwordpasswordtext: Leave empty and a strong one is made for you. Either way, the step returns it.

Outputs

addresstext
created_attext
domaintext
inbox_idtext
passwordtext

Example output

{
  "address": "k3x9q2m7p1ab@maxxspace.com",
  "created_at": "2026-10-15T17:58:07Z",
  "domain": "maxxspace.com",
  "inbox_id": "6ad1142f52ef514b9c0fef28",
  "password": "q7Zr1vKx9LmPw2NcT5yHbE3s"
}

Delete email

Delete one email from an inbox.

Inputs

Inbox addressaddresstextRequired: The inbox's email address, the 'address' 'Create inbox' returned.
Inbox passwordpasswordtextRequired: The inbox's password, the 'password' 'Create inbox' returned.
Email IDmessage_idtextRequired: The email's 'message_id', from 'List emails' or 'Wait for an email'.

Outputs

addresstext
deletedtrue/false
message_idtext

Example output

{
  "address": "k3x9q2m7p1ab@maxxspace.com",
  "deleted": true,
  "message_id": "6ad11460e0b629a3e73e56b5"
}

Delete inbox

Delete an inbox and every email in it. The address stops receiving email.

Inputs

Inbox addressaddresstextRequired: The inbox's email address, the 'address' 'Create inbox' returned.
Inbox passwordpasswordtextRequired: The inbox's password, the 'password' 'Create inbox' returned.

Outputs

addresstext
deletedtrue/false

Example output

{
  "address": "k3x9q2m7p1ab@maxxspace.com",
  "deleted": true
}

Get email

Read one email in full: the text (made from the HTML when the email has no text version), the HTML, every link, the link to click (verify, confirm, sign in...), any verification code and the names of its attachments.

Inputs

Inbox addressaddresstextRequired: The inbox's email address, the 'address' 'Create inbox' returned.
Inbox passwordpasswordtextRequired: The inbox's password, the 'password' 'Create inbox' returned.
Email IDmessage_idtextRequired: The email's 'message_id', from 'List emails' or 'Wait for an email'.
Mark as readmark_as_readtrue/false: Mark the email read once it has been read here.Default: true.

Outputs

addresstext
attachmentslist
cclist
codeslist
from_addresstext
from_nametext
has_attachmentstrue/false
htmltext
linkslist
message_idtext
previewtext
readtrue/false
received_attext
size_bytesnumber
subjecttext
texttext
tolist
verification_codetext
verification_linktext

Example output

{
  "address": "k3x9q2m7p1ab@maxxspace.com",
  "attachments": [],
  "cc": [],
  "codes": [
    "482913"
  ],
  "from_address": "no-reply@acme.example",
  "from_name": "Acme",
  "has_attachments": false,
  "html": "<p>Welcome to Acme!</p><p>Your verification code is <strong>482913</strong>.</p><a href=\"https://acme.example/verify?token=f3a9c1\">Confirm email</a>",
  "links": [
    {
      "text": "Confirm email",
      "url": "https://acme.example/verify?token=f3a9c1"
    }
  ],
  "message_id": "6ad11460e0b629a3e73e56b5",
  "preview": "Your verification code is 482913. Or click the button below to confirm your email address.",
  "read": true,
  "received_at": "2026-10-15T17:58:55Z",
  "size_bytes": 4182,
  "subject": "Confirm your Acme account",
  "text": "Welcome to Acme!\n\nYour verification code is 482913.\n\nOr confirm your email address: https://acme.example/verify?token=f3a9c1",
  "to": [
    "k3x9q2m7p1ab@maxxspace.com"
  ],
  "verification_code": "482913",
  "verification_link": "https://acme.example/verify?token=f3a9c1"
}

Get inbox

Check an inbox still works and see how many emails it holds and how much of its storage they use.

Inputs

Inbox addressaddresstextRequired: The inbox's email address, the 'address' 'Create inbox' returned.
Inbox passwordpasswordtextRequired: The inbox's password, the 'password' 'Create inbox' returned.

Outputs

addresstext
created_attext
inbox_idtext
message_countnumber
storage_limit_bytesnumber
storage_used_bytesnumber

Example output

{
  "address": "k3x9q2m7p1ab@maxxspace.com",
  "created_at": "2026-10-15T17:58:07Z",
  "inbox_id": "6ad1142f52ef514b9c0fef28",
  "message_count": 1,
  "storage_limit_bytes": 40000000,
  "storage_used_bytes": 4182
}

Get raw email

Get an email exactly as it was received, with every header read out (From, Reply-To, Message-ID, DKIM and the rest). Useful for checking how an email was sent.

Inputs

Inbox addressaddresstextRequired: The inbox's email address, the 'address' 'Create inbox' returned.
Inbox passwordpasswordtextRequired: The inbox's password, the 'password' 'Create inbox' returned.
Email IDmessage_idtextRequired: The email's 'message_id', from 'List emails' or 'Wait for an email'.

Outputs

addresstext
headersobject
message_idtext
size_bytesnumber
sourcetext

Example output

{
  "address": "k3x9q2m7p1ab@maxxspace.com",
  "headers": {
    "Date": "Thu, 15 Oct 2026 17:58:55 +0000",
    "From": "Acme <no-reply@acme.example>",
    "Message-ID": "<38b2d374a5abb4f9@acme.example>",
    "Subject": "Confirm your Acme account",
    "To": "k3x9q2m7p1ab@maxxspace.com"
  },
  "message_id": "6ad11460e0b629a3e73e56b5",
  "size_bytes": 4182,
  "source": "From: Acme <no-reply@acme.example>\r\nTo: k3x9q2m7p1ab@maxxspace.com\r\nSubject: Confirm your Acme account\r\n\r\nYour verification code is 482913."
}

List emails

List the emails in an inbox, newest first: sender, subject, a short preview and whether each has been read. Use 'Get email' to read one in full.

Inputs

Inbox addressaddresstextRequired: The inbox's email address, the 'address' 'Create inbox' returned.
Inbox passwordpasswordtextRequired: The inbox's password, the 'password' 'Create inbox' returned.
Unread onlyunread_onlytrue/false: Only list emails that haven't been read yet.Default: false.
From containsfrom_containstext: Only emails whose sender's name or address contains this, such as 'github.com' or 'Acme'. Upper or lower case doesn't matter.
Subject containssubject_containstext: Only emails whose subject contains this, such as 'verify'. Upper or lower case doesn't matter.
Maximum emailslimitnumber: The most emails to list.From 1 to 300. Default: 30.

Outputs

addresstext
message_countnumber
messageslist
total_in_inboxnumber

Example output

{
  "address": "k3x9q2m7p1ab@maxxspace.com",
  "message_count": 1,
  "messages": [
    {
      "from_address": "no-reply@acme.example",
      "from_name": "Acme",
      "has_attachments": false,
      "message_id": "6ad11460e0b629a3e73e56b5",
      "preview": "Your verification code is 482913. Or click the button below to confirm your email address.",
      "read": false,
      "received_at": "2026-10-15T17:58:55Z",
      "size_bytes": 4182,
      "subject": "Confirm your Acme account",
      "to": [
        "k3x9q2m7p1ab@maxxspace.com"
      ]
    }
  ],
  "total_in_inbox": 1
}

Mark email as read or unread

Mark an email read, or unread so 'Wait for an email' and 'List emails' with 'Unread only' pick it up again.

Inputs

Inbox addressaddresstextRequired: The inbox's email address, the 'address' 'Create inbox' returned.
Inbox passwordpasswordtextRequired: The inbox's password, the 'password' 'Create inbox' returned.
Email IDmessage_idtextRequired: The email's 'message_id', from 'List emails' or 'Wait for an email'.
Readreadtrue/false: Tick to mark it read; untick to mark it unread.Default: true.

Outputs

addresstext
message_idtext
readtrue/false

Example output

{
  "address": "k3x9q2m7p1ab@maxxspace.com",
  "message_id": "6ad11460e0b629a3e73e56b5",
  "read": false
}

Wait for an email

Wait for a new email to arrive in an inbox, up to two minutes, then read it: the text, its links, the link to click (verify, confirm, sign in...) and any verification code. Takes the oldest unread email that matches and marks it read, so the next wait gets the next one.

Inputs

Inbox addressaddresstextRequired: The inbox's email address, the 'address' 'Create inbox' returned.
Inbox passwordpasswordtextRequired: The inbox's password, the 'password' 'Create inbox' returned.
From containsfrom_containstext: Only emails whose sender's name or address contains this, such as 'github.com' or 'Acme'. Upper or lower case doesn't matter.
Subject containssubject_containstext: Only emails whose subject contains this, such as 'verify'. Upper or lower case doesn't matter.
Wait up to (seconds)wait_secondsnumber: How long to wait for the email.From 5 to 120. Default: 60.
Stop the workflow if no email arrivesfail_if_nonetrue/false: Turn off to carry on instead, with 'found' set to false.Default: true.

Outputs

addresstext
attachmentslist
cclist
codeslist
foundtrue/false
from_addresstext
from_nametext
has_attachmentstrue/false
htmltext
linkslist
message_idtext
previewtext
readtrue/false
received_attext
size_bytesnumber
subjecttext
texttext
tolist
verification_codetext
verification_linktext
waited_secondsnumber

Example output

{
  "address": "k3x9q2m7p1ab@maxxspace.com",
  "attachments": [],
  "cc": [],
  "codes": [
    "482913"
  ],
  "found": true,
  "from_address": "no-reply@acme.example",
  "from_name": "Acme",
  "has_attachments": false,
  "html": "<p>Welcome to Acme!</p><p>Your verification code is <strong>482913</strong>.</p><a href=\"https://acme.example/verify?token=f3a9c1\">Confirm email</a>",
  "links": [
    {
      "text": "Confirm email",
      "url": "https://acme.example/verify?token=f3a9c1"
    }
  ],
  "message_id": "6ad11460e0b629a3e73e56b5",
  "preview": "Your verification code is 482913. Or click the button below to confirm your email address.",
  "read": true,
  "received_at": "2026-10-15T17:58:55Z",
  "size_bytes": 4182,
  "subject": "Confirm your Acme account",
  "text": "Welcome to Acme!\n\nYour verification code is 482913.\n\nOr confirm your email address: https://acme.example/verify?token=f3a9c1",
  "to": [
    "k3x9q2m7p1ab@maxxspace.com"
  ],
  "verification_code": "482913",
  "verification_link": "https://acme.example/verify?token=f3a9c1",
  "waited_seconds": 7
}

ActionsCopy Anchor Link

Create inboxCopy Anchor Link

Inputs

Outputs

Delete emailCopy Anchor Link

Inputs

Outputs

Delete inboxCopy Anchor Link

Inputs

Outputs

Get emailCopy Anchor Link

Inputs

Outputs

Get inboxCopy Anchor Link

Inputs

Outputs

Get raw emailCopy Anchor Link

Inputs

Outputs

List emailsCopy Anchor Link

Inputs

Outputs

Mark email as read or unreadCopy Anchor Link

Inputs

Outputs

Wait for an emailCopy Anchor Link

Inputs

Outputs

On this page

Actions

Create inbox

Delete email

Delete inbox

Get email

Get inbox

Get raw email

List emails

Mark email as read or unread

Wait for an email