Mail.tm icon

Mail.tm

Interact with the Mail.tm temporary email API

Overview

This node integrates with the Mail.tm temporary email service API, enabling users to manage email accounts, messages, attachments, and perform complex workflows related to temporary emails. It is particularly useful for automating tasks involving disposable email addresses, such as testing signups, receiving verification emails, or filtering inboxes automatically.

For the Workflow resource and operation, the node supports advanced automated actions like applying inbox rules (e.g., deleting spam or marking newsletters as read), summarizing inbox statistics, retrieving the latest unread message and marking it as read, listing available domains for account creation, and waiting for incoming messages with optional subject filtering while extracting URLs from them.

Practical examples include:

  • Automatically cleaning an inbox by deleting unwanted emails and marking others as read based on customizable rules.
  • Waiting for a confirmation email to arrive and extracting verification links for further processing.
  • Getting a quick summary of the inbox status (total and unread messages) to monitor activity.

Properties

Name Meaning
Auth Token Authentication token from a previous step; if provided, overrides credential usage.
Action Workflow action to perform. Options:
- Apply Inbox Rules
- Get Inbox Summary
- Get Latest Unread and Mark as Read
- List Domains
- Wait for Message and Extract URLs
Timeout (Seconds) Time in seconds to wait for a message when using "Wait for Message and Extract URLs" action. Default 60.
Subject Contains Optional text filter to wait for a message whose subject contains this string (used with wait action).
Rules JSON array defining inbox rules to apply, e.g., delete messages from certain senders or mark newsletters as read.

Output

The output JSON structure varies depending on the selected workflow action:

  • Apply Inbox Rules: Returns the result of applying each rule to the inbox messages (not explicitly detailed but generally success/failure per rule).
  • Get Inbox Summary: Provides counts such as total messages and unread messages.
  • Get Latest Unread and Mark as Read: Returns the latest unread message object after marking it as read.
  • List Domains: Returns an array of available domains for creating new email accounts.
  • Wait for Message and Extract URLs: Outputs the matched message object along with an array of extracted URLs found in the message content.

If downloading attachments (not part of Workflow resource but present in the node), binary data would be returned representing the file content.

Dependencies

  • Requires access to the Mail.tm API endpoint (https://api.mail.tm).
  • Needs either an authentication token provided directly or credentials configured in n8n for Mail.tm (email address and password).
  • No additional external dependencies beyond standard HTTP requests.

Troubleshooting

  • Authentication required error: Occurs if neither an auth token nor valid credentials are provided. Ensure you supply one of these.
  • No available domains found: When creating an account, if no domains are returned by the API, account creation cannot proceed.
  • Timeout waiting for message: When using the wait-for-message action, if no matching message arrives within the specified timeout, an error is thrown. Increase timeout or verify that the expected message will arrive.
  • Attachment not found: If trying to download an attachment that does not exist in the specified message, an error is raised.
  • API rate limits or network errors: Standard HTTP request failures may occur; ensure stable internet connection and respect any API usage limits.

Links and References

Discussion