> 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.

# Ihren ersten API-Aufruf durchführen

> Führen Sie Ihren ersten API-Aufruf durch und fragen Sie Ihre Listen ab, sofort auf dieser Website oder von Ihrem eigenen Computer aus.

Der schnellste Weg um zu prüfen, ob alles funktioniert, ist das Abrufen Ihrer Listen. Dieser Aufruf verändert nichts an Ihrem Konto und liefert sofort eine Antwort. Sie können diesen Aufruf direkt hier auf der Website oder von Ihrem eigenen Computer aus durchführen.

## Aufruf über diese Website durchführen

#### Erstellen Sie einen API-Schlüssel

Erstellen Sie in Ihrem Konto unter „Verbindungen“ einen Schlüssel. Ein neuer Schlüssel wird nur ein einziges Mal angezeigt, speichern Sie ihn also sofort ab. Siehe: [API-Schlüssel erstellen](/hoe-kom-ik-aan-een-api-sleutel).

#### Öffnen Sie den Endpoint

Gehen Sie zu [Alle Listen abrufen](/lijsten/alle-lijsten-opvragen).

#### Geben Sie Ihren Schlüssel ein und senden Sie ihn ab

Klicken Sie rechts beim Codebeispiel auf „Try it“ und tragen Sie Ihren Schlüssel bei „api_key“ ein. Klicken Sie danach auf Senden. Mehr über dieses Feld und diese Schaltfläche lesen Sie unter [API mit Try it ausprobieren](/api-uitproberen).

#### Lesen Sie die Antwort

Sie erhalten eine `200`-Antwort mit all Ihren Listen in `data`. Die `list_id`, die Sie dort sehen, benötigen Sie bei fast jedem anderen Aufruf.

> **Warning**
>
> Sie führen hiermit einen echten Aufruf durch. Wie Sie sicher testen, erfahren Sie unter [API mit Try it ausprobieren](/api-uitproberen).

## Aufruf von Ihrem eigenen System aus durchführen

Wie Sie Ihren Schlüssel mitsenden, lesen Sie unter [Authentifizierung mit Ihrem API-Schlüssel](/api-authenticatie).

**`curl`**

```bash title="curl"
curl https://api.laposta.nl/v2/list \
  -u IHR_API_SCHLUESSEL:
```

Mit der PHP-Bibliothek sieht das so aus:

**`PHP`**

```php title="PHP"
$laposta = new Laposta('IHR_API_SCHLUESSEL');
$lijsten = $laposta->listApi()->all();
```

Eine Antwort sieht so aus, hier gekürzt auf eine Liste:

```json
{
  "data": [
    {
      "list": {
        "list_id": "BaImMu3JZA",
        "name": "Newsletter",
        "state": "active",
        "members": { "active": 1232, "unsubscribed": 113, "cleaned": 14 }
      }
    }
  ]
}
```

## Einen Abonnenten hinzufügen

Der Aufruf, den Sie danach wahrscheinlich benötigen, ist das Hinzufügen eines Abonnenten. Neben der E-Mail-Adresse ist auch die IP-Adresse erforderlich, da Sie damit festhalten, woher die Anmeldung stammt.

**`curl`**

```bash title="curl"
curl https://api.laposta.nl/v2/member \
  -u IHR_API_SCHLUESSEL: \
  -d list_id=BaImMu3JZA \
  -d ip=198.51.100.10 \
  -d email=neuer.abonnent@example.net \
  -d custom_fields[voornaam]=Sanne
```

**`PHP`**

```php title="PHP"
$laposta->memberApi()->create('BaImMu3JZA', [
    'ip' => '198.51.100.10',
    'email' => 'neuer.abonnent@example.net',
    'custom_fields' => ['voornaam' => 'Sanne'],
]);
```

Die Schlüssel innerhalb von `custom_fields` sind die `custom_name` Ihrer eigenen Felder. Diese können Sie einmalig über [Alle Felder abrufen](/velden/alle-velden-opvragen) abrufen und in Ihrem eigenen Code speichern.

## Verwandte Artikel

#### [Wie funktioniert die Authentifizierung mit Ihrem API-Schlüssel?](/api-authenticatie)

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

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

Senden Sie aus Ihrem Browser einen echten Aufruf an die Laposta API, ohne etwas zu…

#### [Abonnenten über die API synchronisieren](/relaties-synchroniseren-via-de-api)

Halten Sie Ihre Liste synchron mit Ihrem Webshop oder CRM: Hinzufügen, Aktualisieren…