Ankündigungen3 Min. Lesezeit
Neue API-Endpunkte: Kontakte, Events & Webhooks
Verwalten Sie Kontakte, fragen Sie Events ab und konfigurieren Sie Webhooks programmatisch mit den neuesten Erweiterungen der Emailit-API.
GVonGeorge
Wir haben soeben drei neue Ressourcengruppen in der Emailit-API v2 veröffentlicht: Kontakte, Events und Webhooks. Zusammen geben sie Ihnen die volle programmatische Kontrolle über Ihr Adressbuch, das Monitoring von Events und Ihre Webhook-Integrationen.
Kontakte
Mit der Kontakte-API erstellen, lesen, aktualisieren und löschen Sie Kontakte in Ihrem Workspace. Jeder Kontakt enthält eine E-Mail-Adresse, optional einen Namen und eigene Felder und kann mit einem einzigen Aufruf in eine oder mehrere Kontaktlisten eingetragen werden.
Endpunkt | Beschreibung |
|---|---|
Paginierte Liste aller Kontakte | |
Kontakt über ID oder E-Mail-Adresse abrufen | |
Neuen Kontakt erstellen und in Kontaktlisten eintragen | |
Name, E-Mail, eigene Felder oder Abmeldestatus aktualisieren | |
Kontakt und alle zugehörigen Abonnenten löschen |
Kontakte lassen sich über ihre ID (con_xxx) oder ihre E-Mail-Adresse abrufen, Sie können also die jeweils praktischere Kennung verwenden.
{
"email": "john@example.com",
"first_name": "John",
"last_name": "Doe",
"custom_fields": { "company": "Acme" },
"audiences": ["aud_2BxFg7KNqr5M..."]
}Events
Events entstehen automatisch, sobald in Ihrem Workspace etwas passiert: Eine E-Mail wird zugestellt, ein Kontakt wird angelegt, eine Domain wird aktualisiert und so weiter. Die Events-API gibt Ihnen Lesezugriff auf diesen Aktivitätsstrom.
Endpunkt | Beschreibung |
|---|---|
Paginierte Liste mit Filter nach Typ und optionalem Daten-Payload | |
Einzelnes Event mit vollständigen Daten abrufen |
Sie können mit kommagetrennten Werten nach einem oder mehreren Event-Typen filtern und mit include_data steuern, ob Listenantworten den vollständigen Payload enthalten.
GET /v2/events?type=email.accepted,email.delivered&include_data=trueWebhooks
Mit Webhooks erhalten Sie HTTP-Callbacks in Echtzeit, sobald Events eintreten. Die neue Webhooks-API gibt Ihnen die volle Kontrolle: Sie können Webhook-Endpunkte erstellen, aktualisieren, aktivieren/deaktivieren und löschen, alles über die API.
Endpunkt | Beschreibung |
|---|---|
Paginierte Liste aller Webhooks | |
Webhook über ID abrufen | |
Neuen Webhook-Endpunkt erstellen | |
URL, Events oder Aktivierungsstatus aktualisieren | |
Webhook über ID oder Name löschen |
Sie können bestimmte Event-Typen abonnieren oder mit all_events alles empfangen.
{
"name": "Produktions-Webhook",
"url": "https://example.com/webhook",
"events": ["email.accepted", "email.delivered", "email.bounced"]
}Es gibt über 30 Event-Typen für E-Mails, Domains, Kontaktlisten, Abonnenten, Kontakte, Vorlagen, Sperrungen und E-Mail-Verifizierungen. Die vollständige Liste finden Sie in der Dokumentation zu Webhook erstellen.
Loslegen
Alle drei APIs erfordern einen API-Schlüssel mit Vollzugriff. Entdecken Sie alle neuen Endpunkte in der API-Referenz oder springen Sie direkt in die oben verlinkte Dokumentation.
