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

# La API de Laposta

> Vincula Laposta a tu propio software: sincronizar suscriptores, enviar campañas y recibir eventos mediante webhooks.

Esta es una API REST para desarrolladores que quieren conectar su propio entorno con Laposta. Desde tu propio software puedes gestionar listas, campos, suscriptores, segmentos, campañas, resultados y webhooks. El uso más habitual de la API es colocar directamente las nuevas suscripciones de una tienda online o de un CRM en la lista adecuada.

Todas las llamadas se realizan a través de `https://api.laposta.nl/v2`. La API devuelve respuestas en JSON y utiliza códigos de estado HTTP estándar. La autenticación se realiza mediante basic auth, usando tu clave API como nombre de usuario y dejando la contraseña en blanco. Puedes crear esta clave en tu cuenta, en la sección Conectar. No es necesario utilizar ninguna librería, aunque existen librerías disponibles para PHP y .NET.

Si buscas una integración lista para usar sin necesidad de programar, consulta la sección [Conectar](/koppelingen-overzicht).

## Empieza aquí

#### [Primera llamada a la API](/je-eerste-api-aanroep)

Obtén tus listas en menos de cinco minutos, desde este sitio web o desde tu propio ordenador.

#### [Autenticación con tu clave API](/api-authenticatie)

La API de Laposta utiliza basic auth con tu clave API como nombre de usuario y una contraseña en blanco.

#### [Probar la API con Try it](/api-uitproberen)

Con el botón Try it puedes hacer una llamada real directamente, sin instalar nada.

## Guías

#### [Sincronizar suscriptores a través de la API](/relaties-synchroniseren-via-de-api)

Mantén tu lista en Laposta igual que en tu tienda online o CRM: añadir, actualizar, darse de baja y gestionar los errores adecuadamente.

#### [Usar webhooks para cambios](/webhooks-gebruiken)

Haz que Laposta avise a tu sistema en cuanto alguien se suscriba, se dé de baja o modifique sus datos.

#### [Enviar una campaña a través de la API](/campagne-versturen-via-de-api)

Crea una campaña, rellénala con tu propio html, envía un correo de prueba y programa el envío.

#### [Errores frecuentes con la API](/veelgemaakte-fouten-met-de-api)

Dónde suelen atascarse las integraciones en la práctica, qué mensaje de error recibes y cómo solucionarlo.

## Referencia de la API

La referencia está organizada siguiendo el orden en que construyes una integración: empiezas por una lista, defines qué datos vas a guardar, añades ahí a los suscriptores y solo después pasas al envío.

[Listas Crear, consultar, vaciar y sincronizar de una sola vez. Ver](/lijsten/lijst-toevoegen)

[Campos Determinar qué datos guardas por suscriptor, desde texto hasta selección múltiple. Ver](/velden/veld-toevoegen)

[Suscriptores Añadir, actualizar, darse de baja y consultar el historial. Ver](/relaties/relatie-toevoegen)

[Segmentos Selecciones dentro de una lista, registradas como una definición con bloques y reglas. Ver](/segmenten/segment-toevoegen)

[Campañas Crear, rellenar con tu propio html, probar, programar y enviar. Ver](/campagnes/campagne-aanmaken)

[Resultados Consultar cuántos correos han llegado, se han abierto y han recibido clics. Ver](/resultaten/campagneresultaten-opvragen)

[Webhooks Hacer que Laposta avise a tu sistema en cuanto cambie algo. Ver](/webhooks/webhook-toevoegen)

## Librerías

Puedes llamar a la API directamente, pero para dos lenguajes existe una librería lista para usar que se encarga del trabajo HTTP: [PHP](https://github.com/laposta/laposta-api-php) y [.NET (C#)](https://github.com/laposta/laposta-api-dotnet), ambas con ejemplos para cada apartado.

**`PHP installeren`**

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

En las guías, junto a cada ejemplo de curl, encontrarás también la variante en PHP. En el panel de código de las páginas de los endpoints puedes elegir tú mismo el lenguaje, desde cURL hasta Python, Go y Swift. Esos son ejemplos HTTP normales, sin librería.

## La API con un asistente de IA

No tienes que escribir las llamadas tú mismo. Un asistente de IA puede utilizar los mismos endpoints con tu clave, y existe una skill lista para usar que ya conoce toda la referencia anterior. Todo lo que puedes hacer con ella, cómo configurarla de forma segura y cuáles son sus límites se explica en [Conectar un asistente de IA](/laposta-gebruiken-met-ai).