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

# De Laposta API

> Koppel Laposta aan je eigen software: relaties synchroniseren, campagnes versturen en gebeurtenissen ontvangen via webhooks.

Dit is een REST API voor ontwikkelaars die hun eigen omgeving willen koppelen aan Laposta. Vanuit je eigen software beheer je lijsten, velden, relaties, segmenten, campagnes, resultaten en webhooks. De API wordt het vaakst gebruikt om nieuwe aanmeldingen uit een webshop of CRM direct in de juiste lijst te zetten.

Alle aanroepen lopen via `https://api.laposta.nl/v2`. De API geeft antwoorden terug in JSON en gebruikt standaard HTTP-statuscodes. Authenticatie gaat via basic auth, met je API-sleutel als gebruikersnaam en een leeg wachtwoord. Zo'n sleutel maak je aan in je account onder Koppelingen. Een bibliotheek is niet nodig, maar voor PHP en .NET zijn die er wel.

Zoek je een kant-en-klare koppeling zonder te programmeren, kijk dan bij [Koppelingen](/koppelingen-overzicht).

## Begin hier

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

Haal binnen vijf minuten je lijsten op, vanaf deze site of vanaf je eigen computer.

#### [Authenticatie met je API-sleutel](/api-authenticatie)

De Laposta API gebruikt basic auth met je API-sleutel als gebruikersnaam en een leeg wachtwoord.

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

Met de knop Try it kun je direct een echte aanroep doen, zonder iets te installeren.

## Handleidingen

#### [Relaties synchroniseren via de API](/relaties-synchroniseren-via-de-api)

Houd je lijst in Laposta gelijk aan je webshop of CRM: toevoegen, bijwerken, afmelden en fouten netjes afvangen.

#### [Webhooks gebruiken voor wijzigingen](/webhooks-gebruiken)

Laat Laposta jouw systeem waarschuwen zodra iemand zich aanmeldt, afmeldt of zijn gegevens wijzigt.

#### [Campagne versturen via de API](/campagne-versturen-via-de-api)

Maak een campagne aan, vul hem met je eigen html, verstuur een testmail en plan de verzending in.

#### [Veelgemaakte fouten met de API](/veelgemaakte-fouten-met-de-api)

Waar koppelingen in de praktijk vaak op vastlopen, welke foutmelding je dan krijgt en hoe je het oplost.

## API-referentie

De referentie is ingedeeld zoals je een koppeling opbouwt: je begint bij een lijst, bepaalt welke gegevens je bewaart, zet daar relaties in, en gaat pas daarna versturen.

[Lijsten Aanmaken, opvragen, leegmaken en in een keer synchroniseren. Bekijken](/lijsten/lijst-toevoegen)

[Velden Bepalen welke gegevens je per relatie bewaart, van tekst tot meerkeuze. Bekijken](/velden/veld-toevoegen)

[Relaties Toevoegen, bijwerken, afmelden en de geschiedenis opvragen. Bekijken](/relaties/relatie-toevoegen)

[Segmenten Selecties binnen een lijst, vastgelegd als een definitie met blokken en regels. Bekijken](/segmenten/segment-toevoegen)

[Campagnes Aanmaken, vullen met eigen html, testen, inplannen en versturen. Bekijken](/campagnes/campagne-aanmaken)

[Resultaten Opvragen hoeveel mails er zijn aangekomen, geopend en aangeklikt. Bekijken](/resultaten/campagneresultaten-opvragen)

[Webhooks Laposta jouw systeem laten waarschuwen zodra er iets verandert. Bekijken](/webhooks/webhook-toevoegen)

## Bibliotheken

Je kunt de API rechtstreeks aanroepen, maar voor twee talen is er een kant-en-klare bibliotheek die het HTTP-werk uit handen neemt: [PHP](https://github.com/laposta/laposta-api-php) en [.NET (C#)](https://github.com/laposta/laposta-api-dotnet), allebei met voorbeelden per onderdeel.

**`PHP installeren`**

```bash title="PHP installeren"
composer require laposta/laposta-api-php
```

In de handleidingen staat naast elk curl-voorbeeld ook de PHP-variant. In het codepaneel op de endpoint-pagina's kun je zelf de taal kiezen, van cURL tot Python, Go en Swift. Dat zijn gewone HTTP-voorbeelden, zonder bibliotheek.

## De API met een AI-assistent

Je hoeft de aanroepen niet zelf te schrijven. Een AI-assistent kan met je sleutel dezelfde endpoints gebruiken, en er bestaat een kant-en-klare skill die de hele referentie hierboven al kent. Wat daarmee kan, hoe je het veilig opzet en waar het ophoudt, staat in [AI-assistent koppelen](/laposta-gebruiken-met-ai).