# MailerLiteに購読者を追加する

> Formspree Docs · CLIの使用方法 · 2023年7月14日

**購読者を追加** アクションは、MailerLiteに購読者を追加します。このアクションは内部的に [create subscriber](https://developers.mailerlite.com/reference#create-a-subscriber) APIエンドポイントを呼び出します。また、[購読者をグループに追加する](https://developers.mailerlite.com/reference#add-single-subscriber) こともできます。

`formspree.json` ファイルに **購読者を追加** アクションを追加することは、FormspreeダッシュボードでMailerLiteプラグインを追加するのと同じ効果があります。詳細は [MailerLiteプラグインのヘルプ記事](/articles/plugins/use-mailerlite-to-create-subscribers/) をご覧ください。

## Formspree.jsonの設定

| キー | 型 | 説明 |
| --- | --- | --- |
| `app` |  String | `mailerlite` でなければなりません  |
| `apiKey` |  String | MailerLite APIキー（[こちら](https://app.mailerlite.com/integrations/api/) で確認可能。$ 環境変数参照である必要があります。必須） |
| `type` |  String | `addSubscriber` でなければなりません |
| `groupName` |  String | 省略可能。購読者を追加するグループ。デフォルト：**空** |
| `resubscribe` |  Boolean | 省略可能。**true** の場合、購読者を再アクティブ化します。デフォルト：**false** |
| `autoresponders` |  Boolean | 省略可能。購読時の自動返信を有効にします。**groupName** が空でない場合のみ有効です。デフォルト：**false** |
| `subscriberStatus` |  Enum | 省略可能。**unsubscribed、active**、または **unconfirmed** のいずれか。デフォルト：**active** |
| `requireOptin` |  Boolean | 省略可能。**true** の場合、オプトインフィールドを有効にします：データに `_optin` という名前のフィールドに空でない値が含まれている場合にのみ、送信がMailerLiteに送られます。デフォルト：**false** |

#### **注意事項**

**autoresponders：** グループが選択されている場合のみ有効です。有効にすると、選択したグループの自動返信が送信されます。

**resubscribe：** 有効にしている状態で送信されたメールアドレスが購読者リストにある場合、**購読者ステータス** は無視され、購読者が再アクティブ化されます。
ただし、これは過去に購読者リストに追加されたことのあるメールアドレスにのみ有効です。新しいメールアドレスの場合は、**購読者ステータス** が適用されます。

**requireOptin：** フォームが送信されるたびにMailerLiteリストに連絡先を追加するのではなく、**オプトインチェックボックス** 設定によりプラグインを実行するかどうかを決定するために、`_optin` 特殊フィールドの有無がチェックされます。

#### **例**

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

## バリデーションルール

**購読者を追加** アクションは、以下のバリデーションルールを暗黙的に追加します：

| フィールド | バリデーションルール |
| --- | --- |
| `_replyto` または `email` | 必須 |
| `_replyto` | 型は `email` |
| `email` | 型は `email` |