> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.laposta.org/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.laposta.org/_mcp/server.

# Die Laposta API

> Verbinden Sie Laposta mit Ihrer eigenen Software: Abonnenten synchronisieren, Kampagnen senden und Ereignisse über Webhooks empfangen.

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](/koppelingen-overzicht) nach.

## Hier starten

#### [Erster API-Aufruf](/je-eerste-api-aanroep)

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](/api-authenticatie)

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

#### [API mit Try it ausprobieren](/api-uitproberen)

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](/relaties-synchroniseren-via-de-api)

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](/webhooks-gebruiken)

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

#### [Kampagne über die API versenden](/campagne-versturen-via-de-api)

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](/veelgemaakte-fouten-met-de-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.

[Listen Erstellen, abrufen, leeren und auf einmal synchronisieren. Durchsuchen](/lijsten/lijst-toevoegen)

[Felder Festlegen, welche Daten Sie pro Abonnent speichern, von Text bis Multiple Choice. Durchsuchen](/velden/veld-toevoegen)

[Abonnenten Hinzufügen, aktualisieren, abmelden und die Historie abrufen. Durchsuchen](/relaties/relatie-toevoegen)

[Segmente Auswahlen innerhalb einer Liste, festgelegt als Definition mit Blöcken und Regeln. Durchsuchen](/segmenten/segment-toevoegen)

[Kampagnen Erstellen, mit eigenem HTML-Code füllen, testen, einplanen und versenden. Durchsuchen](/campagnes/campagne-aanmaken)

[Ergebnisse Abrufen, wie viele E-Mails zugestellt, geöffnet und angeklickt wurden. Durchsuchen](/resultaten/campagneresultaten-opvragen)

[Webhooks Ihr System von Laposta benachrichtigen lassen, sobald sich etwas ändert. Durchsuchen](/webhooks/webhook-toevoegen)

## 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](https://github.com/laposta/laposta-api-php) und [.NET (C#)](https://github.com/laposta/laposta-api-dotnet), beide mit Beispielen für jeden Bereich.

**`PHP installeren`**

```bash title="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](/laposta-gebruiken-met-ai).