Changelog: REST-API

Der MCP-Server unter https://api.emailit.com/mcp deckt jetzt alles in API v2 ab:

• Neue Toolsets: Kampagnen, Automatisierungen, Formulare, DMARC-Berichte, E-Mail-Verifizierung, Events, Massenaktionen und Export für Kontakte, Abonnenten sowie Tests, Wiederholungen und Secret-Rotation für Webhooks. Siehe Tool-Referenz.
• Annotationen: Jedes Tool ist als read-only, destructive, idempotent oder open-world gekennzeichnet, damit Clients vor schreibenden Aktionen nachfragen können.
• Strukturierte Ergebnisse: Tools geben JSON als Text und als strukturierten Inhalt für Clients zurück, die ihn parsen.
• Integrierte Anweisungen: Der Server weist Assistenten an, Empfänger vor dem Senden zu bestätigen und vor jedem Löschen nachzufragen.
• Toolsets und Nur-Lesen-Modus: Laden Sie weniger Tools mit ?toolsets= oder blenden Sie schreibende Tools mit ?read_only=true aus. Siehe Toolsets.
• Zustandsloser Transport: Keine MCP-Sitzungen, die ablaufen können; Clients senden jede Anfrage mit POST.

Behoben: OAuth-Verbindungen, die mit den Scopes sending und full genehmigt wurden, funktionieren jetzt mit jedem Tool, und der Workspace, zu dem Sie wechseln, bleibt ausgewählt, nachdem der Client sein Token aktualisiert hat.

• API-Schlüssel, die erstellt wurden, bevor Schlüssel das Präfix secret_ hatten, werden unter /v2 wieder akzeptiert.
• E-Mail abrufen gibt das vollständige E-Mail-Objekt zurück, einschließlich object, from und to.
• Antworten zu Domains geben track_loads und track_clicks wie dokumentiert als 0 oder 1 zurück.

Öffnen Sie Email API → Logs, um erfolgreiche und fehlgeschlagene Anfragen von der letzten Stunde bis zu den letzten 30 Tagen zu sehen. Filtern Sie nach Quelle (API oder SMTP), Ergebnis, Methode, Pfad, Statuscode, Dauer oder API-Schlüssel und öffnen Sie eine Anfrage, um ihren Anfrage- und Antwort-Body zu sehen. Sensible Werte werden geschwärzt und lange Bodys gekürzt.

Siehe Anfrage-Logs.

Kombinieren Sie in der Weboberfläche unter Filters Bedingungen mit Match all oder Match any, klicken Sie zum Sortieren auf Spaltenüberschriften und wählen Sie Spalten unter Display options.

Filtern Sie in der API mit Query-Parametern im Format field.condition=value, kombinieren Sie sie mit match=all oder match=or und sortieren Sie mit order und direction:

curl "https://api.emailit.com/v2/emails?status.exact=bounced&created_at.after=2026-09-01&order=created_at&direction=desc" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Jeder Listen-Endpunkt dokumentiert seine filterbaren Felder. Siehe Filtern.

• Kontakte: Kontakte erstellen, auflisten, abrufen, aktualisieren und löschen. Suchen Sie einen Kontakt über seine con_-ID oder E-Mail-Adresse und fügen Sie ihn im selben Aufruf zu Kontaktlisten hinzu.
• Events: Events auflisten, gefiltert nach einem oder mehreren Typen und optional mit ihren Daten, und ein einzelnes Event abrufen.
• Webhooks: Webhook-Endpunkte erstellen, auflisten, abrufen, aktualisieren und löschen.

Diese Endpunkte erfordern einen Schlüssel mit Vollzugriff. Siehe API-Referenz.

IDs sind dienstübergreifend eindeutig und lassen sich nach dem Erstellungszeitpunkt sortieren. Gängige Präfixe sind em_ für E-Mails, dom_ für Domains, key_ für API-Schlüssel, aud_ für Kontaktlisten, sub_ für Abonnenten, con_ für Kontakte, sup_ für Sperrungen, wh_ für Webhooks, evt_ für Events und cmp_ für Kampagnen.

Speichern Sie IDs als opake Strings, statt sie zu parsen.

Neue Funktionen erscheinen nur in API v2 unter https://api.emailit.com/v2. Wenn Sie noch /v1 aufrufen, wechseln Sie zu den v2-Endpunkten und senden Sie Ihren API-Schlüssel im Header Authorization: Bearer.

Siehe Versionierung.

API-Schlüssel ersetzen Zugangsdaten. Ein Schlüssel hat den Scope full oder sending, ein Sende-Schlüssel lässt sich auf eine Versanddomain beschränken und Sie können Schlüssel per API verwalten. API v1 blieb während Ihrer Migration verfügbar.

Siehe API-Referenz.