Die Laposta API

Dies ist eine REST API für Entwickler, die ihre eigene Umgebung mit Laposta verbinden möchten. Über Ihre eigene Software verwalten Sie Listen, Felder, Abonnenten, Segmente, Kampagnen, Ergebnisse und Webhooks. Am häufigsten wird die API genutzt, um neue Anmeldungen aus einem Webshop oder CRM direkt in die richtige Liste einzutragen.

Alle Aufrufe erfolgen über https://api.laposta.nl/v2. Die API gibt Antworten im JSON-Format zurück und verwendet Standard-HTTP-Statuscodes. Die Authentifizierung erfolgt über Basic Auth, mit Ihrem API-Schlüssel als Benutzername und einem leeren Passwort. Einen solchen Schlüssel erstellen Sie in Ihrem Konto unter Verbindungen. Eine Bibliothek ist nicht erforderlich, für PHP und .NET stehen jedoch Bibliotheken zur Verfügung.

Wenn Sie eine fertige Verbindung ohne Programmieraufwand suchen, schauen Sie unter Verbindungen nach.

Hier starten

Erster API-Aufruf

Rufen Sie innerhalb von fünf Minuten Ihre Listen ab, direkt von dieser Website oder von Ihrem eigenen Computer aus.

Authentifizierung mit Ihrem API-Schlüssel

Die Laposta API verwendet Basic Auth mit Ihrem API-Schlüssel als Benutzername und einem leeren Passwort.

API mit Try it ausprobieren

Mit der Schaltfläche Try it können Sie sofort einen echten Aufruf durchführen, ohne etwas zu installieren.

Anleitungen

Abonnenten über die API synchronisieren

Halten Sie Ihre Liste in Laposta auf demselben Stand wie Ihren Webshop oder Ihr CRM: hinzufügen, aktualisieren, abmelden und Fehler sauber abfangen.

Webhooks für Änderungen verwenden

Lassen Sie Ihr System von Laposta benachrichtigen, sobald sich jemand anmeldet, abmeldet oder seine Daten ändert.

Kampagne über die API versenden

Erstellen Sie eine Kampagne, füllen Sie sie mit Ihrem eigenen HTML-Code, senden Sie eine Test-E-Mail und planen Sie den Versand ein.

Häufige Fehler bei der API

Woran Verbindungen in der Praxis oft scheitern, welche Fehlermeldung Sie dann erhalten und wie Sie das Problem lösen.

API-Referenz

Die Referenz ist so aufgebaut, wie Sie eine Verbindung einrichten: Sie beginnen mit einer Liste, legen fest, welche Daten Sie speichern, fügen dort Abonnenten hinzu und beginnen erst danach mit dem Versand.

ListenErstellen, abrufen, leeren und auf einmal synchronisieren.Durchsuchen FelderFestlegen, welche Daten Sie pro Abonnent speichern, von Text bis Multiple Choice.Durchsuchen AbonnentenHinzufügen, aktualisieren, abmelden und die Historie abrufen.Durchsuchen SegmenteAuswahlen innerhalb einer Liste, festgelegt als Definition mit Blöcken und Regeln.Durchsuchen KampagnenErstellen, mit eigenem HTML-Code füllen, testen, einplanen und versenden.Durchsuchen ErgebnisseAbrufen, wie viele E-Mails zugestellt, geöffnet und angeklickt wurden.Durchsuchen WebhooksIhr System von Laposta benachrichtigen lassen, sobald sich etwas ändert.Durchsuchen

Bibliotheken

Sie können die API direkt aufrufen, aber für zwei Sprachen gibt es eine fertige Bibliothek, die Ihnen die HTTP-Arbeit abnimmt: PHP und .NET (C#), beide mit Beispielen für jeden Bereich.

PHP installeren

composer require laposta/laposta-api-php

In den Anleitungen steht neben jedem cURL-Beispiel auch die PHP-Variante. Im Code-Bereich auf den Endpoint-Seiten können Sie die Sprache selbst wählen, von cURL bis Python, Go und Swift. Das sind normale HTTP-Beispiele ohne Bibliothek.

Die API mit einem KI-Assistenten

Sie müssen die Aufrufe nicht selbst schreiben. Ein KI-Assistent kann mit Ihrem Schlüssel dieselben Endpoints verwenden, und es gibt einen fertigen Skill, der die gesamte obige Referenz bereits kennt. Was damit möglich ist, wie Sie es sicher einrichten und wo die Grenzen liegen, erfahren Sie unter KI-Assistenten verbinden.