Neue API-Endpunkte: Kontakte, Events & Webhooks
Wir haben soeben drei neue Ressourcengruppen in der Emailit API v2 veröffentlicht: Kontakte, Ereignisse und Webhooks. Zusammen geben sie Ihnen die vollständige programmatische Kontrolle über Ihr Adressbuch, die Überwachung von Ereignissen und Webhook-Integrationen.
Kontakte
Die Kontakte-API ermöglicht es Ihnen, Kontakte in Ihrem Arbeitsbereich zu erstellen, abzurufen, zu aktualisieren und zu löschen. Jeder Kontakt enthält eine E-Mail-Adresse, einen optionalen Namen und benutzerdefinierte Felder und kann mit einem einzigen Aufruf für eine oder mehrere Zielgruppen angemeldet werden.
| Endpunkt | Beschreibung |
|---|---|
| Kontakte auflisten | Paginierte Liste aller Kontakte |
| Kontakt abrufen | Kontakt über ID oder E-Mail-Adresse abrufen |
| Kontakt erstellen | Neuen Kontakt erstellen und für Zielgruppen anmelden |
| Kontakt aktualisieren | Name, E-Mail, benutzerdefinierte Felder oder Abmeldestatus aktualisieren |
| Kontakt löschen | Kontakt und alle zugehörigen Abonnenten löschen |
Kontakte können über ihre ID (con_xxx) oder über die E-Mail-Adresse gesucht werden, sodass Sie den für Sie praktischsten Identifikator verwenden können.
{
"email": "john@example.com",
"first_name": "John",
"last_name": "Doe",
"custom_fields": { "company": "Acme" },
"audiences": ["aud_2BxFg7KNqr5M..."]
}
Ereignisse
Ereignisse werden automatisch erstellt, wenn etwas in Ihrem Arbeitsbereich passiert. Zum Beispiel wird eine E-Mail zugestellt, ein Kontakt wird erstellt, eine Domain wird aktualisiert und so weiter. Die Ereignisse-API gibt Ihnen schreibgeschützten Zugriff auf diesen Aktivitätsstrom.
| Endpunkt | Beschreibung |
|---|---|
| Ereignisse auflisten | Paginierte Liste mit Typfilterung und optionaler Datennutzlast |
| Ereignis abrufen | Einzelnes Ereignis mit vollständigen Daten abrufen |
Sie können nach einem oder mehreren Ereignistypen mit kommagetrennten Werten filtern und include_data umschalten, um zu steuern, ob die vollständige Nutzlast in Listenantworten zurückgegeben wird.
GET /v2/events?type=email.accepted,email.delivered&include_data=true
Webhooks
Webhooks ermöglichen es Ihnen, HTTP-Callbacks in Echtzeit zu erhalten, wann immer Ereignisse auftreten. Die neue Webhooks-API gibt Ihnen die vollständige Kontrolle. Sie können Webhook-Endpunkte erstellen, aktualisieren, aktivieren/deaktivieren und löschen – alles über die API.
| Endpunkt | Beschreibung |
|---|---|
| Webhooks auflisten | Paginierte Liste aller Webhooks |
| Webhook abrufen | Webhook über ID abrufen |
| Webhook erstellen | Neuen Webhook-Endpunkt erstellen |
| Webhook aktualisieren | URL, Ereignisse oder Aktivierungsstatus aktualisieren |
| Webhook löschen | Webhook über ID oder Name löschen |
Sie können bestimmte Ereignistypen abonnieren oder all_events verwenden, um alles zu erhalten.
{
"name": "Produktions-Webhook",
"url": "https://example.com/webhook",
"events": ["email.accepted", "email.delivered", "email.bounced"]
}
Es stehen über 30 Ereignistypen für E-Mails, Domains, Zielgruppen, Abonnenten, Kontakte, Vorlagen, Unterdrückungen und E-Mail-Verifizierungen zur Verfügung. Die vollständige Liste finden Sie in der Dokumentation zu Webhook erstellen.
Erste Schritte
Alle drei APIs benötigen einen API-Schlüssel mit vollständigen Berechtigungen. Schauen Sie sich die API-Referenz an, um alle neuen Endpunkte zu erkunden, oder springen Sie direkt in die oben verlinkte Dokumentation.
Blog
Die neuesten Nachrichten und Updates, direkt von Emailit.
Bleiben Sie auf dem Laufenden mit den neuesten Artikeln aus dem Emailit Blog.