# Ajouter des abonnés à ConvertKit

> Formspree Docs · Utiliser le CLI · 14 juillet 2023

L'action **apply tags** ajoute un abonné à ConvertKit et lui applique un ou plusieurs tags. En coulisses, cette action appelle le point d'entrée API [**tag a subscriber**](https://developers.convertkit.com/#tag-a-subscriber). En cas d'échec, nous réessaierons automatiquement.

Ajouter l'action **apply tags** dans le fichier `formspree.json` produit le même effet qu'ajouter le plugin ConvertKit dans le tableau de bord Formspree.

## Configuration formspree.json

| Clé | Type | Description |
| --- | --- | --- |
| `app` |  String |  Doit être `convertkit`  |
| `type` |  String |  Doit être `applyTags` |
| `tags` |  Array |  Une liste de tags à appliquer à l'abonné (requis) |
| `apiKey` |  String |  Votre clé API ConvertKit disponible [ici](https://app.convertkit.com/account/edit) (doit être une référence de variable d'environnement $, requis) |

**Exemple**

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

## Règles de validation

L'action **apply tags** ajoute implicitement les règles de validation suivantes :

| Champ | Règle de validation |
| --- | --- |
| `email` | Requis |
| `email` | Le type est `email` |
