# Agregar suscriptores a MailerLite

> Formspree Docs · Usar el CLI · 14 de julio de 2023

La acción **add subscriber** agrega suscriptores a MailerLite. Internamente, esta acción llama al endpoint de la API [create subscriber](https://developers.mailerlite.com/reference#create-a-subscriber). Además, es posible que quieras [añadir el suscriptor a un grupo.](https://developers.mailerlite.com/reference#add-single-subscriber)

Agregar la acción **add subscriber** en el archivo `formspree.json` tiene el mismo efecto que añadir el plugin de MailerLite en el panel de Formspree. Consulta el [artículo de ayuda del plugin de MailerLite](/es/articles/plugins/use-mailerlite-to-create-subscribers/) para más información. 

## Configuración de Formspree.json

| Clave | Tipo | Descripción |
| --- | --- | --- |
| `app` |  String | Debe ser `mailerlite`  |
| `apiKey` |  String | Tu clave de API de MailerLite, que puedes encontrar [aquí](https://app.mailerlite.com/integrations/api/) (debe ser una referencia a una variable de entorno con `$`, requerido) |
| `type` |  String | Debe ser `addSubscriber` |
| `groupName` |  String | Opcional. Grupo al que se añadirán los suscriptores. Por defecto: **vacío** |
| `resubscribe` |  Boolean | Opcional. Reactiva al suscriptor si el valor es **true**. Por defecto: **false** |
| `autoresponders` |  Boolean | Opcional. Habilita los autorespondedores de suscripción. Solo tiene efecto si **groupName** no está vacío. Por defecto: **false** |
| `subscriberStatus` |  Enum | Opcional. Uno de **unsubscribed, active,** o **unconfirmed**. Por defecto: **active** |
| `requireOptin` |  Boolean | Opcional. Si es **true**, habilita el campo de opt-in: los envíos solo se enviarán a MailerLite si hay un campo llamado `_optin` con un valor no vacío en los datos. Por defecto: **false** |

#### **Notas**

**autoresponders:** esto solo tiene efecto si se selecciona un grupo. Si está habilitado, se enviarán los autorespondedores del grupo seleccionado.

**resubscribe:** si está habilitado y el correo enviado está en tu lista de suscriptores, se ignorará el **Subscriber Status** y se reactivará al suscriptor.  
Ten en cuenta que esto solo funciona para correos que ya hayan sido añadidos a tu lista de suscriptores. Para correos nuevos se usará el **Subscriber Status**. 

**requireOptin:** en lugar de añadir un contacto a la lista de MailerLite cada vez que se envía el formulario, la opción **Opt-in Checkbox** primero comprobará la presencia de un campo especial `_optin` para determinar si el plugin debe ejecutarse.

#### **Ejemplo**

```javascript
{
  "forms": {
    "contact": {
      "name": "Contact Form",
      "actions": [
        {
          "app": "mailerlite",
          "apiKey": "$MAILERLITE_API_KEY",
          "type": "addSubscriber",
          "groupName": "Formspree Test",
          "resubscribe": false,
          "autoresponders": false,
          "subscriberStatus": "active",
          "requireOptin": false
        }
      ]
    }
  }
}
```

## Reglas de validación

La acción **add subscriber** añade implícitamente las siguientes reglas de validación:

| Campo | Regla de validación |
| --- | --- |
| `_replyto` o `email` | Requerido |
| `_replyto` | El tipo es `email` |
| `email` | El tipo es `email` |