Referenz
Changelog: API-Schlüssel
Änderungen im Bereich API-Schlüssel: neue Funktionen, Verbesserungen und Fehlerbehebungen.
Oktober 2026
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 Parameterscope. - 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.
identifyordnet 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:*undc:*alle Workspace-Events oder alle eigenen Events. - API und MCP. Die APIs für Workspace-Events und Tracking-Schlüssel sowie das Tool
send-eventund die Tools für Workspace-Events im MCP-Toolsetevents. - 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.
- Zwei Scopes. Workspace-Events (
September 2026
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/v2wieder akzeptiert. - E-Mail abrufen gibt das vollständige E-Mail-Objekt zurück, einschließlich
object,fromundto. - Antworten zu Domains geben
track_loadsundtrack_clickswie dokumentiert als0oder1zurück.
- API-Schlüssel, die erstellt wurden, bevor Schlüssel das Präfix
Geändert
Reine Sende-Schlüssel auf Sende-Endpunkte beschränkt
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
Neu
API v2
REST-APIAPI-SchlüsselVersanddomainsKontaktlistenSperrungen
API-Schlüssel ersetzen Zugangsdaten. Ein Schlüssel hat den Scope
fullodersending, 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.