# Abonnenten zu MailerLite hinzufügen

> Formspree Docs · Die CLI verwenden · 14. Juli 2023

Die Aktion **add subscriber** fügt Abonnenten zu MailerLite hinzu. Im Hintergrund ruft diese Aktion den API-Endpoint [create subscriber](https://developers.mailerlite.com/reference#create-a-subscriber) auf. Außerdem möchtest du den Abonnenten möglicherweise [zu einer Gruppe hinzufügen.](https://developers.mailerlite.com/reference#add-single-subscriber)

Das Hinzufügen der Aktion **add subscriber** in der Datei `formspree.json` hat denselben Effekt wie das Hinzufügen des MailerLite-Plugins im Formspree-Dashboard. Weitere Informationen findest du im [Hilfeartikel zum MailerLite-Plugin](/articles/plugins/use-mailerlite-to-create-subscribers/).

## Formspree.json-Konfiguration

| Schlüssel | Typ | Beschreibung |
| --- | --- | --- |
| `app` |  String | Muss `mailerlite` sein  |
| `apiKey` |  String | Dein MailerLite-API-Schlüssel, den du [hier](https://app.mailerlite.com/integrations/api/) findest (muss eine $-Umgebungsvariablen-Referenz sein, erforderlich) |
| `type` |  String | Muss `addSubscriber` sein |
| `groupName` |  String | Optional. Gruppe, zu der Abonnenten hinzugefügt werden. Standard: **leer** |
| `resubscribe` |  Boolean | Optional. Reaktiviert den Abonnenten, wenn der Wert **true** ist. Standard: **false** |
| `autoresponders` |  Boolean | Optional. Aktiviert Abonnement-Autoresponder. Wird nur wirksam, wenn **groupName** nicht leer ist. Standard: **false** |
| `subscriberStatus` |  Enum | Optional. Einer von **unsubscribed, active,** oder **unconfirmed**. Standard: **active** |
| `requireOptin` |  Boolean | Optional. Wenn **true**, wird das Opt-in-Feld aktiviert: Übermittlungen werden nur an MailerLite gesendet, wenn ein Feld namens `_optin` mit einem nicht-leeren Wert in den Daten vorhanden ist. Standard: **false** |

#### **Hinweise**

**autoresponders:** Dies wird nur wirksam, wenn eine Gruppe ausgewählt ist. Wenn es aktiviert ist, werden die Autoresponder der ausgewählten Gruppe gesendet.

**resubscribe:** Wenn es aktiviert ist und die gesendete E-Mail in deiner Abonnentenliste steht, wird der **Subscriber Status** ignoriert und der Abonnent reaktiviert.  
Beachte, dass dies nur für E-Mails funktioniert, die schon einmal zu deiner Abonnentenliste hinzugefügt wurden. Für neue E-Mails wird stattdessen der **Subscriber Status** verwendet.

**requireOptin:** Anstatt bei jeder Formularübermittlung einen Kontakt zur MailerLite-Liste hinzuzufügen, prüft die Einstellung **Opt-in Checkbox** zunächst das Vorhandensein eines speziellen Feldes `_optin`, um zu bestimmen, ob das Plugin ausgelöst werden soll.

#### **Beispiel**

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

## Validierungsregeln

Die Aktion **add subscriber** fügt implizit die folgenden Validierungsregeln hinzu:

| Feld | Validierungsregel |
| --- | --- |
| `_replyto` oder `email` | Erforderlich |
| `_replyto` | Typ ist `email` |
| `email` | Typ ist `email` |