Skip to navigation

De Laposta API

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.

Begin hier

Eerste API-aanroep

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

Authenticatie met je API-sleutel

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

API uitproberen met Try it

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

Handleidingen

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

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

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

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.

LijstenAanmaken, opvragen, leegmaken en in een keer synchroniseren.BekijkenVeldenBepalen welke gegevens je per relatie bewaart, van tekst tot meerkeuze.BekijkenRelatiesToevoegen, bijwerken, afmelden en de geschiedenis opvragen.BekijkenSegmentenSelecties binnen een lijst, vastgelegd als een definitie met blokken en regels.BekijkenCampagnesAanmaken, vullen met eigen html, testen, inplannen en versturen.BekijkenResultatenOpvragen hoeveel mails er zijn aangekomen, geopend en aangeklikt.BekijkenWebhooksLaposta jouw systeem laten waarschuwen zodra er iets verandert.Bekijken

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 en .NET (C#), allebei met voorbeelden per onderdeel.

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.