# Mailchimpリストに購読者を追加する

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

**連絡先を追加または更新** アクションは、Mailchimpオーディエンスの連絡先を追加または更新します。このアクションは内部的に [**add or update a list member**](https://mailchimp.com/developer/reference/lists/list-members/#put_/lists/-list_id-/members/-subscriber_hash-) APIエンドポイントを呼び出します。呼び出しが失敗した場合は、自動的に再試行します。

`formspree.json` ファイルに **連絡先を追加または更新** アクションを追加することは、FormspreeダッシュボードでMailchimpプラグインを追加するのと同じ効果があります。詳細は [Mailchimpプラグインのヘルプ記事](/articles/plugins/use-mailchimp-to-collect-email-addresses/) をご覧ください。

## Formspree.jsonの設定

| キー | 型 | 説明 |
| --- | --- | --- |
| `app` |  String | `mailchimp` でなければなりません |
| `type`  |  String | `addOrUpdateContact` でなければなりません |
| `audience` |  String | MailchimpオーディエンスID（静的な値、必須。環境変数参照の使用を推奨）。[Mailchimp Audience IDの確認方法](https://mailchimp.com/help/find-audience-id/) を参照してください。 |
| `apiKey` |  String | APIキー（$ 環境変数参照である必要があります。必須） |

**例**

```javascript
{
  "forms": {
    "contact": {
      "name": "Contact Form",
      "actions": [
        {
          "app": "mailchimp",
          "type": "addOrUpdateContact",
          "audience": "$MAILCHIMP_AUDIENCE",
          "apiKey": "$MAILCHIMP_APIKEY"
        }
      ]
    }
  }
}
```

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

**連絡先を追加または更新** アクションは、以下のバリデーションルールを暗黙的に追加します：

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