# Aggiungere iscritti a una lista Mailchimp

> Formspree Docs · Usare la CLI · 14 luglio 2023

L'azione **add or update contact** aggiunge o aggiorna un contatto in un'audience di Mailchimp. Dietro le quinte, questa azione chiama l'endpoint API [**add or update a list member**](https://mailchimp.com/developer/reference/lists/list-members/#put_/lists/-list_id-/members/-subscriber_hash-). Se la chiamata fallisce, la ritenteremo al posto tuo.

Aggiungere l'azione **add or update contact** nel file `formspree.json` ha lo stesso effetto di aggiungere il plugin Mailchimp nella dashboard di Formspree. Consulta l'[articolo di aiuto sul plugin Mailchimp](/articles/plugins/use-mailchimp-to-collect-email-addresses/) per maggiori informazioni.

## Configurazione di Formspree.json

| Chiave | Tipo | Descrizione |
| --- | --- | --- |
| `app` |  String | Deve essere `mailchimp` |
| `type`  |  String | Deve essere `addOrUpdateContact` |
| `audience` |  String | L'ID della tua audience Mailchimp (un valore statico, obbligatorio; ti consigliamo di usare un riferimento a una variabile d'ambiente). Consulta [Find your Mailchimp Audience ID](https://mailchimp.com/help/find-audience-id/). |
| `apiKey` |  String | La tua API key (deve essere un riferimento a una variabile d'ambiente con $, obbligatorio) |

**Esempio**

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

## Regole di validazione

L'azione **add or update contact** aggiunge implicitamente le seguenti regole di validazione:

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