# Aggiungere iscritti a una lista Klaviyo

> Formspree Docs · Usare la CLI · 14 luglio 2023

L'azione **subscribe profile** iscrive un profilo a una lista Klaviyo. Dietro le quinte, questa azione chiama l'endpoint API [subscribe profiles to list](https://developers.klaviyo.com/en/reference/subscribe). Se la chiamata fallisce, la ritenteremo al posto tuo.

Aggiungere l'azione **subscribe profile** nel file `formspree.json` ha lo stesso effetto di aggiungere il plugin Klaviyo nella dashboard di Formspree. Consulta l'articolo di aiuto sul plugin Klaviyo per maggiori informazioni.

## Configurazione di Formspree.json

| Chiave | Tipo | Descrizione |
| --- | --- | --- |
| `app` |  String | Deve essere `klaviyo` |
| `type`  |  String | Deve essere `addSubscriber` |
| `listName` |  String | Il nome della tua lista Klaviyo. Deve corrispondere esattamente al nome, rispettando maiuscole e minuscole. |
| `apiKey` |  String | La tua API key (deve essere un riferimento a una variabile d'ambiente con $, obbligatorio) |
| `defaultPhoneRegion` |  String | Opzionale. Codice ISO del Paese per completare i numeri di telefono con il prefisso telefonico nazionale. Consulta la sezione sui numeri di telefono nella [documentazione di Klaviyo](/articles/plugins/adding-subscribers-to-klaviyo-list/) per maggiori informazioni. |

**Esempio**

```javascript
{
  "forms": {
    "contact": {
      "name": "Contact Form",
      "actions": [
        {
          "app": "klaviyo",
          "type": "addSubscriber",
          "listName": "Newsletter",
          "defaultPhoneRegion": "US",
          "apiKey": "$KLAVIYO_API_KEY"
        }
      ]
    }
  }
}
```

## 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` |