# Aggiungere iscritti a ConvertKit

> Formspree Docs · Usare la CLI · 14 luglio 2023

L'azione **apply tags** aggiunge un iscritto a ConvertKit e applica uno o più tag. Dietro le quinte, questa azione chiama l'endpoint API [**tag a subscriber**](https://developers.convertkit.com/#tag-a-subscriber). Se la chiamata fallisce, la ritenteremo al posto tuo.

Aggiungere l'azione **apply tags** nel file `formspree.json` ha lo stesso effetto di aggiungere il plugin ConvertKit nella dashboard di Formspree.

## Configurazione di Formspree.json

| Chiave | Tipo | Descrizione |
| --- | --- | --- |
| `app` |  String |  Deve essere `convertkit`  |
| `type` |  String |  Deve essere `applyTags` |
| `tags` |  Array |  Un elenco di tag da applicare all'iscritto (obbligatorio) |
| `apiKey` |  String |  La tua API key di ConvertKit, che trovi [qui](https://app.convertkit.com/account/edit) (deve essere un riferimento a una variabile d'ambiente con $, obbligatorio) |

**Esempio**

```javascript
{
  "forms": {
    "contact": {
      "name": "Contact Form",
      "actions": [
        {
          "app": "convertkit",
          "type": "applyTags",
          "tags": ["Newsletter"],
          "apiKey": "$CONVERTKIT_API_KEY"
        }
      ]
    }
  }
}
```

## Regole di validazione

L'azione **apply tags** aggiunge implicitamente le seguenti regole di validazione:

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