# Agregar suscriptores a ConvertKit

> Formspree Docs · Usar el CLI · 14 de julio de 2023

La acción **apply tags** agrega un suscriptor a ConvertKit y le aplica una o más etiquetas. Internamente, esta acción llama al endpoint de la API [**tag a subscriber**](https://developers.convertkit.com/#tag-a-subscriber). Si la llamada falla, la reintentaremos por ti.

Agregar la acción **apply tags** en el archivo `formspree.json` tiene el mismo efecto que añadir el plugin de ConvertKit en el panel de Formspree.

## Configuración de Formspree.json

| Clave | Tipo | Descripción |
| --- | --- | --- |
| `app` |  String |  Debe ser `convertkit`  |
| `type` |  String |  Debe ser `applyTags` |
| `tags` |  Array |  Una lista de etiquetas a aplicar al suscriptor (requerido) |
| `apiKey` |  String |  Tu clave de API de ConvertKit, que puedes encontrar [aquí](https://app.convertkit.com/account/edit) (debe ser una referencia a una variable de entorno con `$`, requerido) |

**Ejemplo**

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

## Reglas de validación

La acción **apply tags** añade implícitamente las siguientes reglas de validación:

| Campo | Regla de validación |
| --- | --- |
| `email` | Requerido |
| `email` | El tipo es `email` |