# Abonnenten zu ConvertKit hinzufügen

> Formspree Docs · Die CLI verwenden · 14. Juli 2023

Die Aktion **apply tags** fügt einen Abonnenten zu ConvertKit hinzu und wendet ein oder mehrere Tags an. Im Hintergrund ruft diese Aktion den API-Endpoint [**tag a subscriber**](https://developers.convertkit.com/#tag-a-subscriber) auf. Falls der Aufruf fehlschlägt, wiederholen wir ihn für dich.

Das Hinzufügen der Aktion **apply tags** in der Datei `formspree.json` hat denselben Effekt wie das Hinzufügen des ConvertKit-Plugins im Formspree-Dashboard.

## Formspree.json-Konfiguration

| Schlüssel | Typ | Beschreibung |
| --- | --- | --- |
| `app` |  String |  Muss `convertkit` sein  |
| `type` |  String |  Muss `applyTags` sein |
| `tags` |  Array |  Eine Liste von Tags, die auf den Abonnenten angewendet werden (erforderlich) |
| `apiKey` |  String |  Dein ConvertKit-API-Schlüssel, den du [hier](https://app.convertkit.com/account/edit) findest (muss eine $-Umgebungsvariablen-Referenz sein, erforderlich) |

**Beispiel**

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

## Validierungsregeln

Die Aktion **apply tags** fügt implizit die folgenden Validierungsregeln hinzu:

| Feld | Validierungsregel |
| --- | --- |
| `email` | Erforderlich |
| `email` | Typ ist `email` |