# Aggiungere iscritti a MailerLite

> Formspree Docs · Usare la CLI · 14 luglio 2023

L'azione **add subscriber** aggiunge iscritti a MailerLite. Dietro le quinte, questa azione chiama l'endpoint API [create subscriber](https://developers.mailerlite.com/reference#create-a-subscriber). Inoltre, potresti voler [aggiungere l'iscritto a un gruppo.](https://developers.mailerlite.com/reference#add-single-subscriber)

Aggiungere l'azione **add subscriber** nel file `formspree.json` ha lo stesso effetto di aggiungere il plugin MailerLite nella dashboard di Formspree. Consulta l'[articolo di aiuto sul plugin MailerLite](/articles/plugins/use-mailerlite-to-create-subscribers/) per maggiori informazioni.

## Configurazione di Formspree.json

| Chiave | Tipo | Descrizione |
| --- | --- | --- |
| `app` |  String | Deve essere `mailerlite`  |
| `apiKey` |  String | La tua API key di MailerLite, che trovi [qui](https://app.mailerlite.com/integrations/api/) (deve essere un riferimento a una variabile d'ambiente con $, obbligatorio) |
| `type` |  String | Deve essere `addSubscriber` |
| `groupName` |  String | Opzionale. Gruppo a cui verranno aggiunti gli iscritti. Predefinito: **vuoto** |
| `resubscribe` |  Boolean | Opzionale. Riattiva l'iscritto se il valore è **true**. Predefinito: **false** |
| `autoresponders` |  Boolean | Opzionale. Abilita gli autorisponditori dell'iscrizione. Ha effetto solo se **groupName** non è vuoto. Predefinito: **false** |
| `subscriberStatus` |  Enum | Opzionale. Uno tra **unsubscribed, active,** o **unconfirmed**. Predefinito: **active** |
| `requireOptin` |  Boolean | Opzionale. Se **true**, abilita il campo opt-in: gli invii verranno inviati a MailerLite solo se nei dati è presente un campo chiamato `_optin` con un valore non vuoto. Predefinito: **false** |

#### **Note**

**autoresponders:** Ha effetto solo se è selezionato un gruppo. Se è abilitato, verranno inviati gli autorisponditori del gruppo selezionato.

**resubscribe:** Se è abilitato e l'email inviata è nella tua lista di iscritti, lo **Subscriber Status** verrà ignorato e l'iscritto verrà riattivato.  
Tieni presente che funziona solo per le email che sono già state aggiunte alla tua lista di iscritti. Per le nuove email, verrà invece preso in considerazione lo **Subscriber Status**.

**requireOptin:** Invece di aggiungere un contatto alla lista MailerLite ogni volta che il modulo viene inviato, l'impostazione **Opt-in Checkbox** verificherà prima la presenza di un campo speciale `_optin` per determinare se il plugin debba essere attivato.

#### **Esempio**

```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
        }
      ]
    }
  }
}
```

## Regole di validazione

L'azione **add subscriber** aggiunge implicitamente le seguenti regole di validazione:

| Campo | Regola di validazione |
| --- | --- |
| `_replyto` o `email` | Obbligatorio |
| `_replyto` | Il tipo è `email` |
| `email` | Il tipo è `email` |