Zum Inhalt springen
Doku

Referenz

Changelog: API-Schlüssel

Änderungen im Bereich API-Schlüssel: neue Funktionen, Verbesserungen und Fehlerbehebungen.

Oktober 2026

  1. Neu

    Event-Tracking: Workspace-Events und eigene Events

    Event-TrackingAPI-SchlüsselWebhooks

    Sie können jetzt neben den Events, die Emailit erfasst, Ihre eigenen senden, etwa eine Bestellung, einen Tarifwechsel oder einen Produktaufruf. Sie finden die neuen Funktionen in den Tabs Workspace events und Tracking unter Email API > Events.

    • Zwei Scopes. Workspace-Events (w:<name>) werden vorab mit typisierten Eigenschaften festgelegt, und Emailit lehnt Events ab, die nicht dazu passen. Eigene Events (c:<name>) nehmen ein beliebiges JSON-Objekt an. Das Event-Log hat einen Filter Scope und die API Events auflisten einen Parameter scope.
    • Von Ihren Servern. Event senden erfasst ein Event, Events gesammelt senden bis zu 100. Beide funktionieren mit den neuen API-Schlüsseln mit dem Scope Events Only, die Events senden, aber keine Daten lesen und keine E-Mails senden können.
    • Von Ihrer Website. Das Tracking-Skript sendet Events mit einem öffentlichen Tracking-Schlüssel, den Sie auf Ihre eigenen Websites beschränken können. identify ordnet die Events eines Besuchers einem Kontakt zu.
    • Kontakte und Webhooks. Events erscheinen im Activity log des Kontakts. Webhooks empfangen die Typen, die Sie auswählen, oder mit w:* und c:* alle Workspace-Events oder alle eigenen Events.
    • API und MCP. Die APIs für Workspace-Events und Tracking-Schlüssel sowie das Tool send-event und die Tools für Workspace-Events im MCP-Toolset events.
    • Tarife. Event-Tracking und das Tracking-Skript sind in den Tarifen Pro, Business und Custom enthalten. Pro kann 100 Event-Typen nutzen, Business 1.000, und Custom hat kein Limit. Siehe Limits.

    Siehe Event-Tracking.

September 2026

  1. Behoben

    Kompatibilitätskorrekturen für API v2

    REST-APIAPI-SchlüsselE-Mail-APIVersanddomains

    • 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.
  2. Geändert

    Reine Sende-Schlüssel auf Sende-Endpunkte beschränkt

    API-SchlüsselE-Mail-API

    Reine Sende-Schlüssel konnten bisher E-Mails auflisten und abrufen und einige andere lesende Endpunkte aufrufen. Jetzt sind sie auf E-Mail senden und die Aktionen für eine bestehende E-Mail beschränkt: verschieben, stornieren, erneut senden und weiterleiten. Andere Endpunkte lehnen Sende-Schlüssel ab.

    Wenn Ihre Integration auch E-Mails, Domains oder andere Ressourcen liest, verwenden Sie für diese Aufrufe einen Schlüssel mit Vollzugriff. Siehe API-Schlüssel.

Oktober 2025

  1. Neu

    API v2

    REST-APIAPI-SchlüsselVersanddomainsKontaktlistenSperrungen

    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.

War diese Seite hilfreich?

Danke für Ihr Feedback.

Danke, wir lesen jede Nachricht.