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

# Hacer tu primera llamada a la API

> Haz tu primera llamada a la API y solicita tus listas, directamente en este sitio web o desde tu propio ordenador.

La forma más rápida de comprobar si todo funciona es consultar tus listas. Esa llamada no modifica nada en tu cuenta y da una respuesta inmediata. Puedes hacer esta llamada desde este mismo sitio web o desde tu propio ordenador.

## Hacer la llamada desde este sitio web

#### Crea una clave API

Crea una clave en tu cuenta en el apartado «Conectar». Una clave nueva solo se muestra una vez, así que guárdala de inmediato. Ver: [Crear una clave API](/hoe-kom-ik-aan-een-api-sleutel).

#### Abre el endpoint

Ve a [Obtener todas las listas](/lijsten/alle-lijsten-opvragen).

#### Introduce tu clave y envíala

Haz clic a la derecha del ejemplo de código en «Try it» e introduce tu clave en «api_key». Después, haz clic en enviar. Puedes leer más sobre este campo y este botón en [Probar la API con Try it](/api-uitproberen).

#### Lee la respuesta

Recibirás una respuesta `200` con todas tus listas en `data`. Necesitarás el `list_id` que ves ahí para casi cualquier otra llamada.

> **Warning**
>
> Con esto estás haciendo una llamada real. En [Probar la API con Try it](/api-uitproberen) se explica cómo hacer pruebas de forma segura.

## Hacer la llamada desde tu propio sistema

Puedes consultar cómo enviar tu clave en [Autenticación con tu clave API](/api-authenticatie).

**`curl`**

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

Con la biblioteca PHP sería así:

**`PHP`**

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

Una respuesta tiene este aspecto, abreviada a una sola lista:

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

## Añadir un suscriptor

La llamada que probablemente necesitarás después es la de añadir un suscriptor. Además de la dirección de correo electrónico, la dirección IP es obligatoria, ya que con ella registras desde dónde se realizó la suscripción.

**`curl`**

```bash title="curl"
curl https://api.laposta.nl/v2/member \
  -u TU_CLAVE_API: \
  -d list_id=BaImMu3JZA \
  -d ip=198.51.100.10 \
  -d email=nuevo.suscriptor@example.net \
  -d custom_fields[nombre]=Lucía
```

**`PHP`**

```php title="PHP"
$laposta->memberApi()->create('BaImMu3JZA', [
    'ip' => '198.51.100.10',
    'email' => 'nuevo.suscriptor@example.net',
    'custom_fields' => ['nombre' => 'Lucía'],
]);
```

Las claves dentro de `custom_fields` corresponden al `custom_name` de tus propios campos. Puedes obtenerlas una sola vez mediante [Obtener todos los campos](/velden/alle-velden-opvragen) y guardarlas en tu propio código.

## Artículos relacionados

#### [¿Cómo funciona la autenticación con tu clave API?](/api-authenticatie)

La API utiliza basic auth, con tu clave como nombre de usuario y una contraseña vacía.

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

Envía desde tu navegador una llamada real a la API de Laposta, sin instalar nada.

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

Mantén tu lista igual que tu tienda online o CRM: añadir, actualizar, darse de baja y…