The Laposta API

This is a REST API for developers who want to connect their own environment to Laposta. From your own software, you can manage lists, fields, subscribers, segments, campaigns, results and webhooks. The API is most commonly used to place new sign-ups from an online shop or CRM directly into the right list.

All calls are made via https://api.laposta.nl/v2. The API returns responses in JSON and uses standard HTTP status codes. Authentication uses basic auth, with your API key as the username and an empty password. You can create an API key in your account under Connect. A library is not required, though libraries are available for PHP and .NET.

If you are looking for a ready-made integration that does not require any programming, take a look at Connect.

Start here

First API call

Retrieve your lists within five minutes, either from this site or from your own computer.

Authentication with your API key

The Laposta API uses basic auth with your API key as the username and an empty password.

Trying out the API with Try it

With the Try it button, you can make a live call straight away without installing anything.

Guides

Synchronising subscribers through the API

Keep your list in Laposta in sync with your online shop or CRM: adding, updating, unsubscribing and handling errors neatly.

Using webhooks for changes

Have Laposta notify your system as soon as someone subscribes, unsubscribes or updates their details.

Sending a campaign through the API

Create a campaign, populate it with your own HTML, send a testmail and schedule the delivery.

Common mistakes with the API

What integrations often get stuck on in practice, which error message you get and how to solve it.

API reference

The reference is structured in the same order as you build an integration: you start with a list, decide which data to store, add subscribers to it, and only then start sending.

ListsCreate, retrieve, empty and synchronise all at once.View FieldsDetermine which details you store per subscriber, from text to multiple choice.View SubscribersAdd, update, unsubscribe and retrieve the history.View SegmentsSelections within a list, saved as a definition using blocks and rules.View CampaignsCreate, populate with your own HTML, test, schedule and send.View ResultsRetrieve how many emails were delivered, opened and clicked.View WebhooksHave Laposta notify your system as soon as something changes.View

Libraries

You can call the API directly, but ready-made libraries are available for two languages to take care of the HTTP work for you: PHP and .NET (C#), both with examples for each section.

PHP installeren

composer require laposta/laposta-api-php

In the guides, you will find the PHP version alongside every curl example. In the code panel on the endpoint pages, you can choose the language yourself, from cURL to Python, Go and Swift. These are standard HTTP examples, without a library.

The API with an AI assistant

You do not have to write the calls yourself. An AI assistant can use the same endpoints with your key, and there is a ready-made skill that already knows the entire reference above. What you can do with it, how to set it up safely and where its limits lie is explained in Connect an AI assistant.