n8n-nodes-email-api

Ein vollständiger n8n Community Node für Email API Service Integration mit IMAP, SMTP und erweiterten E-Mail-Management-Funktionen.

🚀 Features

✅ Account Management

• Erstellen, Aktualisieren, Löschen von E-Mail-Konten
• IMAP & SMTP Verbindungstest
• Unterstützung für Gmail, Outlook, und alle IMAP/SMTP-Server

✅ Mailbox Management

• Postfächer auflisten, erstellen, löschen, umbenennen
• Dynamische Mailbox-Auswahl in der UI

✅ Message Operations

• Nachrichten auflisten mit erweiterten Filtern
• Nachrichten lesen, verschieben, kopieren, löschen
• Flags setzen (gelesen, wichtig, beantwortet)
• Custom Headers setzen und aktualisieren

✅ SMTP

• E-Mails versenden mit Text/HTML
• CC, BCC, Reply-To Support
• E-Mail Threading (In-Reply-To, References)
• Custom Headers für Tracking und Kategorisierung

✅ Advanced Features

• API Key & JWT Authentifizierung
• Pagination Support
• Filter nach Datum, Absender, Empfänger, Betreff
• Continue on Fail Error Handling

📦 Installation

Über n8n Community Nodes

1. Öffne n8n
2. Gehe zu Settings → Community Nodes
3. Klicke auf Install
4. Gib ein: @martin_sol_95/n8n-nodes-email-api
5. Klicke auf Install

Über npm (für lokale n8n Installation)

cd ~/.n8n/nodes
npm install @martin_sol_95/n8n-nodes-email-api

Manuelle Installation

# Node herunterladen
git clone https://github.com/martin-sol/n8n-nodes-email-api.git
cd n8n-nodes-email-api

# Dependencies installieren und bauen
npm install
npm run build

# In n8n verlinken
npm link
cd ~/.n8n/nodes
npm link @martin_sol_95/n8n-nodes-email-api

# n8n neu starten

🔧 Setup

1. Email API Service einrichten

Dieser Node benötigt einen laufenden Email API Service:

git clone https://github.com/martin-sol/email_api_service.git
cd email_api_service
# Siehe README für Setup-Anleitung

2. Credentials erstellen

In n8n:

1. Gehe zu Credentials → New
2. Suche nach Email API
3. Fülle aus:
   • API Base URL: https://your-api.example.com/api
   • Auth Type: API Key oder JWT
   • API Key: Dein API Key
4. Klicke Save (automatischer Test)

📖 Verwendung

Beispiel 1: E-Mail-Konto hinzufügen

Resource: Account
Operation: Create
E-Mail: user@gmail.com
IMAP Host: imap.gmail.com
IMAP Port: 993
SMTP Host: smtp.gmail.com
SMTP Port: 587
Password: app-password

Beispiel 2: Ungelesene E-Mails abrufen

Resource: Message
Operation: List
Account ID: 1
Mailbox Name: INBOX (Dropdown-Auswahl)
Additional Options:
  - Seen: false
  - Limit: 50

Beispiel 3: E-Mail mit Custom Headers versenden

Resource: SMTP
Operation: Send
Account ID: 1
To: recipient@example.com
Subject: Test E-Mail
Body Text: Inhalt...
Additional Options:
  - Custom Headers:
    - X-AI-Processed: true
    - X-Category: Support

Beispiel 4: E-Mail-Threading (Antworten)

Resource: SMTP
Operation: Send
To: {{ $json.from }}
Subject: Re: {{ $json.subject }}
Additional Options:
  - In-Reply-To: {{ $json.message_id }}
  - References: {{ $json.references }}

🎯 Use Cases

• E-Mail-Automatisierung: Automatisches Verarbeiten eingehender E-Mails
• KI-Integration: E-Mails mit KI analysieren und Custom Headers setzen
• Support-Workflows: Automatische Kategorisierung und Weiterleitung
• E-Mail-Tracking: Custom Headers für Tracking und Reporting
• Multi-Account Management: Mehrere E-Mail-Konten zentral verwalten

📚 Dokumentation

• Setup Guide
• Custom Headers Guide
• API Endpoints Mapping
• Changelog

🔄 Updates

Version 0.2.1

• ✅ Dynamische Mailbox-Auswahl (Dropdowns)
• ✅ Intelligente Sortierung (INBOX zuerst)

Version 0.2.0

• ✅ Custom Headers Support
• ✅ Message Update Headers Operation
• ✅ SMTP Custom Headers

Version 0.1.1

• ✅ E-Mail Threading (In-Reply-To, References)

Version 0.1.0

• ✅ Initial Release
• ✅ Account, Mailbox, Message, SMTP Operations

🤝 Contributing

Contributions sind willkommen! Bitte erstelle ein Issue oder Pull Request auf GitHub.

📄 Lizenz

MIT License - siehe LICENSE Datei

🙏 Support

• Issues: GitHub Issues
• Dokumentation: GitHub Wiki
• n8n Community: n8n Forum

🔗 Links

• Email API Service
• n8n
• n8n Community Nodes

---

Entwickelt mit ❤️ für die n8n Community