# Ajouter des abonnés à MailerLite

> Formspree Docs · Utiliser le CLI · 14 juillet 2023

L'action **add subscriber** ajoute des abonnés à MailerLite. En coulisses, cette action appelle le point d'entrée API [create subscriber](https://developers.mailerlite.com/reference#create-a-subscriber). Vous pouvez également [ajouter l'abonné à un groupe.](https://developers.mailerlite.com/reference#add-single-subscriber)

Ajouter l'action **add subscriber** dans le fichier `formspree.json` produit le même effet qu'ajouter le plugin MailerLite dans le tableau de bord Formspree. Consultez l'[article d'aide sur le plugin MailerLite](/articles/plugins/use-mailerlite-to-create-subscribers/) pour plus d'informations.

## Configuration formspree.json

| Clé | Type | Description |
| --- | --- | --- |
| `app` |  String | Doit être `mailerlite`  |
| `apiKey` |  String | Votre clé API MailerLite disponible [ici](https://app.mailerlite.com/integrations/api/) (doit être une référence de variable d'environnement $, requis) |
| `type` |  String | Doit être `addSubscriber` |
| `groupName` |  String | Optionnel. Groupe auquel les abonnés seront ajoutés. Par défaut : **vide** |
| `resubscribe` |  Boolean | Optionnel. Réactive l'abonné si la valeur est **true**. Par défaut : **false** |
| `autoresponders` |  Boolean | Optionnel. Active les répondeurs automatiques d'abonnement. Ne prend effet que si **groupName** n'est pas vide. Par défaut : **false** |
| `subscriberStatus` |  Enum | Optionnel. L'une des valeurs suivantes : **unsubscribed, active** ou **unconfirmed**. Par défaut : **active** |
| `requireOptin` |  Boolean | Optionnel. Si **true**, active le champ opt-in : les soumissions ne seront envoyées à MailerLite que si un champ nommé `_optin` avec une valeur non vide est présent dans les données. Par défaut : **false** |

#### **Remarques**

**autoresponders :** Ne prend effet que si un groupe est sélectionné. Si activé, les répondeurs automatiques du groupe sélectionné seront envoyés.

**resubscribe :** Si activé et que l'adresse e-mail envoyée se trouve dans votre liste d'abonnés, le **Statut d'abonné** sera ignoré et l'abonné sera réactivé.  
Notez que cela ne fonctionne que pour les adresses e-mail qui ont déjà été ajoutées à votre liste. Pour les nouvelles adresses, le **Statut d'abonné** sera utilisé à la place.

**requireOptin :** Au lieu d'ajouter un contact à la liste MailerLite à chaque soumission du formulaire, le paramètre **Opt-in Checkbox** vérifiera d'abord la présence d'un champ spécial `_optin` pour déterminer si le plugin doit être déclenché.

#### **Exemple**

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

## Règles de validation

L'action **add subscriber** ajoute implicitement les règles de validation suivantes :

| Champ | Règle de validation |
| --- | --- |
| `_replyto` ou `email` | Requis |
| `_replyto` | Le type est `email` |
| `email` | Le type est `email` |