n8n-nodes-mailhooks

This is an n8n community node for Mailhooks - a service for receiving, filtering, and processing emails via webhooks and API.

n8n is a fair-code licensed workflow automation platform.

Installation Nodes Credentials Usage Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

Or install directly in n8n:

1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-mailhooks
4. Agree to the risks and select Install

Nodes

This package includes three nodes:

Mailhooks

The main node for interacting with the Mailhooks API.

Email Operations:

• List - List emails with optional filters (from, to, subject, date range, read status)
• Get - Get a specific email by ID
• Get Content - Get the HTML and text content of an email
• Delete - Delete an email
• Mark as Read - Mark an email as read
• Mark as Unread - Mark an email as unread
• Download EML - Download email in EML format
• Download Attachment - Download a specific attachment
• Wait For - Wait for an email matching filters (useful for testing flows)

Inbox Operations:

• List - List all inboxes
• Get - Get a specific inbox by ID
• Create - Create a new inbox

Webhook Operations:

• List - List all webhooks
• Get - Get a specific webhook by ID
• Create - Create a new webhook (specify URL and events)
• Update - Update a webhook (URL, active status)
• Delete - Delete a webhook

Domain Operations:

• List - List all domains
• Verify - Trigger domain verification

Utility Operations:

• Parse EML - Parse raw EML content into structured data
• Verify Webhook - Verify a webhook signature

Mailhooks Trigger

A webhook trigger that starts the workflow when a new email is received. When the workflow is activated, this node automatically creates a webhook in Mailhooks pointing at n8n's webhook URL. When the workflow is deactivated, the webhook is automatically removed.

Features:

• Automatically registers a Mailhooks webhook on workflow activation
• Automatically removes the webhook on workflow deactivation
• Optional inbox filter to restrict trigger to a specific inbox
• Optional signature verification for security
• Returns full email data including headers, body, attachments, and authentication results (SPF, DKIM, DMARC)

Mailhooks Polling Trigger

A polling trigger that checks for new emails at regular intervals. Useful when webhooks are not available or as a fallback.

Features:

• Configurable polling interval (set in n8n workflow settings)
• Filter by sender, recipient, or subject
• Only processes emails received after workflow activation

Credentials

To use the Mailhooks nodes, you need to configure credentials:

1. Sign up at mailhooks.dev
2. Go to your dashboard and copy your API key
3. In n8n, create new Mailhooks API credentials
4. Enter your API key

| Field | Description | |-------|-------------| | API Key | Your Mailhooks API key from the dashboard | | Base URL | The API base URL (default: https://mailhooks.dev/api) |

Usage

Receiving emails via webhook

1. Add a Mailhooks Trigger node to your workflow
2. Configure your Mailhooks API credentials
3. (Optional) Select a specific inbox to filter by
4. (Optional) Add a webhook secret for signature verification
5. Activate the workflow — the webhook is created automatically

Polling for new emails

1. Add a Mailhooks Polling Trigger node to your workflow
2. Configure the polling interval in the workflow settings
3. Optionally add filters for sender, recipient, or subject
4. Activate the workflow

Working with emails

Use the Mailhooks node to:

• List and search emails
• Get email content and attachments
• Delete emails
• Mark emails as read/unread
• Wait for specific emails (great for automated testing)

Managing inboxes

Use the Mailhooks node with the Inbox resource to:

• List all inboxes
• Get inbox details
• Create new inboxes

Managing webhooks

Use the Mailhooks node with the Webhook resource to:

• List all webhooks
• Get webhook details
• Create, update, or delete webhooks

Managing domains

Use the Mailhooks node with the Domain resource to:

• List all domains
• Trigger domain verification

Example: Process incoming emails

[Mailhooks Trigger] → [IF] → [Slack]
                         ↓
                    [Google Sheets]

1. Trigger on new email (webhook auto-registered)
2. Check if subject contains "urgent"
3. Send to Slack if urgent, otherwise log to Google Sheets

Resources

• Mailhooks Documentation
• Mailhooks SDK
• n8n Community Nodes Documentation
• GitHub Repository

License

MIT