Recursos · Integración n8n

Integración ConvertKit n8nAutomatiza ConvertKit con n8n.

¿Y si cada compra o cada etiqueta en ConvertKit arrancara un flujo de trabajo? La integración ConvertKit n8n trae un nodo con 15 operaciones sobre 5 recursos y un trigger que escucha 10 eventos. Pensada para quien gestiona formularios, etiquetas y secuencias sin programar.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Qué resuelve la integración ConvertKit n8n?

El nodo ConvertKit habla con la API de ConvertKit desde dentro de un flujo de trabajo. Cubre 5 recursos, los campos personalizados, los formularios, las secuencias, las etiquetas y los suscriptores etiquetados, con 15 operaciones en total. Aparte, un nodo trigger arranca un flujo con 10 eventos de ConvertKit repartidos en 7 familias. Ambos leen la misma clave de API, así que una sola credencial cubre la pareja.

Lo que más cambia el día a día es la reacción automática. El trigger salta con productPurchase o con tagAdd y el flujo responde en la misma ejecución: quien compra entra en una secuencia de bienvenida mediante sequence.addSubscriber, el responsable de la cuenta recibe un aviso en Slack y la ficha queda etiquetada para la próxima campaña. Ni calendario, ni revisiones manuales.

Después llega el momento de sacar datos. tagSubscriber.getAll y sequence.getSubscriptions devuelven los suscriptores de una etiqueta o de una secuencia con sus datos, y Return All activado hace que n8n recorra las páginas de la API hasta traer la lista entera. Un segmento sale así hacia un informe, hacia una plataforma de webinars o hacia los envíos transaccionales de SendGrid.

Queda la puerta de entrada, que en muchos equipos sigue abierta de par en par. El formulario de alta vive fuera de ConvertKit, en una web propia o en una hoja de cálculo, y quien lo rellena nunca llega a la lista. Un flujo que lee la fila nueva y ejecuta form.addSubscriber cierra ese hueco con nombre y campos personalizados incluidos, y de paso deja copia en Google Sheets para el equipo comercial.

Todo lo que queda fuera de las 15 operaciones del catálogo se resuelve con el nodo HTTP Request, que llama a cualquier endpoint de la API de ConvertKit reutilizando la misma credencial mediante la autenticación predefinida. Es la vía habitual para ampliar la pareja, no un apaño. Dos costumbres ahorran tiempo: crear el campo personalizado antes de que una operación de suscriptor intente rellenarlo, y recordar que un campo marcado como obligatorio y vacío detiene la ejecución del nodo.

¿Aún dudas entre varias plataformas antes de montar nada? La Reseña n8n repasa los criterios uno a uno, y el Curso n8n monta este tipo de flujo paso a paso.

Conexión

¿Cómo se conecta ConvertKit con n8n?

  1. 01

    Copia la clave de API desde ConvertKit

    Solo hace falta una cuenta de ConvertKit. Abre los ajustes de la cuenta (Account Settings), entra en la sección Advanced y copia la clave de API que aparece ahí. Ese único valor es el que pide n8n y sirve tanto para el nodo ConvertKit como para el ConvertKit Trigger, así que no hay nada más que generar en ConvertKit antes de empezar a montar el flujo.

  2. 02

    Crea la credencial ConvertKit en n8n

    En n8n, abre el menú Credentials y crea una credencial ConvertKit, es decir un juego de acceso guardado una sola vez. Pega el valor copiado en el campo llamado API Secret y guárdalo con un nombre que reconozcas dentro de unos meses. Una credencial se reutiliza en todos los flujos de la instancia, de modo que este paso no se repite.

  3. 03

    Elige la credencial y carga una lista

    Coloca un nodo ConvertKit en el lienzo y selecciona tu credencial en el desplegable de la parte superior. Elige un recurso y abre el selector Form Name or ID o Tag Name or ID: si n8n rellena la lista con tus formularios y tus etiquetas reales, la clave funciona. Repite la misma selección en el nodo trigger.

Disparadores

¿Qué puede arrancar un flujo desde ConvertKit ?

ConvertKit Trigger es el nodo que arranca un workflow cuando algo ocurre en ConvertKit. Escucha 10 eventos, listados abajo por familia. Eliges uno o varios, activas el workflow y n8n registra el webhook (la URL que ConvertKit llama) en tu cuenta.

Lo que ves en n8n

Todos los eventos, por familia

Una fila por objeto, un chip por acción. El evento que marcas en el nodo se escribe objeto.acción; pasa el cursor por un chip para leer cuándo se dispara.

course.*2
    subscriber.*2
      tag.*2
        form.*1
          link.*1
            product.*1
              purchase.*1

                Notas de configuración

                01Configure the ConvertKit TriggerEl ConvertKit Trigger es un nodo aparte que abre el flujo en lugar de cerrarlo. Eliges un valor en Event y, al activar el flujo, n8n registra un webhook en ConvertKit, o sea una URL a la que ConvertKit llama cada vez que ocurre ese evento. El aviso llega a n8n en cuestión de segundos, sin polling y sin ningún intervalo que ajustar. El nodo está en la versión 1 y usa la misma credencial que el nodo de acciones.

                El ConvertKit Trigger es un nodo aparte que abre el flujo en lugar de cerrarlo. Eliges un valor en Event y, al activar el flujo, n8n registra un webhook en ConvertKit, o sea una URL a la que ConvertKit llama cada vez que ocurre ese evento. El aviso llega a n8n en cuestión de segundos, sin polling y sin ningún intervalo que ajustar. El nodo está en la versión 1 y usa la misma credencial que el nodo de acciones.

                Parámetros clave

                • Event: el evento de ConvertKit que escucha este flujo, uno de los 10 disponibles repartidos en 7 familias. Cada nodo trigger escucha un evento, así que reaccionar a dos cosas distintas pide dos nodos trigger o dos flujos.
                Cuándo usarlo
                siempre que el punto de partida sea de ConvertKit y no tuyo, un alta nueva, una compra o una etiqueta que alguien puso a mano.
                02Form Subscribe, Sequence Subscribe and Sequence CompleteTres eventos siguen el recorrido de un lector por tus contenidos. formSubscribe salta cuando alguien se apunta con un formulario, courseSubscribe cuando un suscriptor entra en una secuencia y courseComplete cuando llega al final. Entre la familia form y la familia course suman 3 de los 10 eventos.

                Tres eventos siguen el recorrido de un lector por tus contenidos. formSubscribe salta cuando alguien se apunta con un formulario, courseSubscribe cuando un suscriptor entra en una secuencia y courseComplete cuando llega al final. Entre la familia form y la familia course suman 3 de los 10 eventos.

                Parámetros clave

                • Form Name or ID: el formulario vigilado para formSubscribe. Sale de la lista que n8n carga con tu credencial, o se indica con un identificador mediante una expresión cuando cambia en cada ejecución.
                • Sequence Name or ID: la secuencia vigilada para courseSubscribe y courseComplete, con el mismo criterio.
                Cuándo usarlo
                terminar una secuencia es buen momento para proponer el siguiente paso, y el alta en un formulario es donde toca enriquecer la ficha, antes del primer correo.
                03Tag Add, Tag Remove, Subscriber Activated and Subscriber UnsubscribeCuatro eventos cuentan lo que cambia en la ficha del suscriptor. tagAdd y tagRemove saltan cuando se pone o se quita una etiqueta, lo haya hecho una persona desde ConvertKit o una automatización. subscriberActivate y subscriberUnsubscribe marcan los dos extremos de la relación. Son 4 de los 10 eventos, entre la familia tag y la familia subscriber.

                Cuatro eventos cuentan lo que cambia en la ficha del suscriptor. tagAdd y tagRemove saltan cuando se pone o se quita una etiqueta, lo haya hecho una persona desde ConvertKit o una automatización. subscriberActivate y subscriberUnsubscribe marcan los dos extremos de la relación. Son 4 de los 10 eventos, entre la familia tag y la familia subscriber.

                Parámetros clave

                • Tag Name or ID: la etiqueta que vigilan tagAdd y tagRemove, elegida en la lista cargada o indicada con una expresión.
                Cuándo usarlo
                en la mayoría de cuentas de ConvertKit la intención se codifica con etiquetas, y por eso tagAdd suele ser el relevo más limpio entre alguien que clica dentro de ConvertKit y un flujo que hace el resto. La baja también merece su sitio, porque es el momento de avisar al resto de sistemas que escriben a esa dirección.
                04Link Click, Product Purchase and Purchase CreatedLos tres eventos restantes nacen de lo que un suscriptor hace con un enlace o con su dinero. linkClick salta al clicar una URL que tú señalas, productPurchase cuando se compra un producto concreto y purchaseCreate cuando se crea una compra. Cada uno ocupa su propia familia, y eso explica en parte por qué hay 7 familias para 10 eventos.

                Los tres eventos restantes nacen de lo que un suscriptor hace con un enlace o con su dinero. linkClick salta al clicar una URL que tú señalas, productPurchase cuando se compra un producto concreto y purchaseCreate cuando se crea una compra. Cada uno ocupa su propia familia, y eso explica en parte por qué hay 7 familias para 10 eventos.

                Parámetros clave

                • Initiating Link: la URL del enlace que origina el disparo de linkClick, escrita entera en vez de elegirse en una lista.
                • Product ID: el identificador del producto que vigila productPurchase, también escrito como valor.
                Cuándo usarlo
                un clic en el enlace de precios es una señal comercial que merece llegar a una persona, y una compra es el arranque natural de una secuencia de bienvenida.
                Acciones

                ¿Qué sabe hacer el nodo ConvertKit dentro de un flujo?

                El nodo ConvertKit expone 15 operaciones en 5 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

                Matriz recursos × operaciones
                RecursoCreateGet ManyUpdateDeleteAddAdd SubscriberGet Subscriptions
                Custom Field✓✓✓✓
                Form✓✓✓
                Sequence✓✓✓
                Tag✓✓
                Tag Subscriber✓✓✓

                Custom Field

                4 operaciones
                01

                Create a custom field

                customField.create

                Lo que ves en n8n

                Notas y casos de uso

                Los campos personalizados guardan lo que ConvertKit no almacena de serie: el nombre de un plan, el origen de una captación. Esta operación crea uno en la cuenta para que las operaciones de suscriptor tengan dónde escribir.

                Parámetros clave

                • Label: la etiqueta del campo personalizado, la que verás luego en ConvertKit y en el selector Add Custom Field de las operaciones de suscriptor.
                Casos de uso
                una tienda crea una vez el campo Last Order Total durante la puesta en marcha y lo rellena en cada pedido que procesa el flujo.
                02

                Delete a custom field

                customField.delete

                Lo que ves en n8n

                Notas y casos de uso

                Los campos se acumulan más rápido de lo que parece, y uno que nadie rellena vuelve la cuenta ilegible. Esta operación elimina un campo de ConvertKit.

                Parámetros clave

                • Field ID: el identificador del campo personalizado, no su etiqueta. Cuando solo conoces el texto, Get many custom fields es quien te da ese identificador.
                Casos de uso
                un flujo de limpieza trimestral borra los campos que dejó un formulario antiguo, con la lista aprobada antes por una persona.
                03

                Get many custom fields

                customField.getAll

                Lo que ves en n8n

                Notas y casos de uso

                Lista los campos personalizados definidos en la cuenta, cada uno con su etiqueta y su identificador. Es la operación que convierte un nombre de campo que conoces en el identificador que piden la actualización y el borrado.

                Parámetros clave

                • Return All: activado, n8n recorre las páginas de la API y trae todos los campos de la cuenta; desactivado, Limit pone el tope de campos devueltos.
                Casos de uso
                un flujo lee la lista de campos al empezar y solo crea uno nuevo cuando la etiqueta falta de verdad.
                04

                Update a custom field

                customField.update

                Lo que ves en n8n

                Notas y casos de uso

                Cambia la etiqueta de un campo que ya existe en ConvertKit. Viene bien cuando el nombre elegido con prisas deja de encajar con lo que el campo guarda.

                Parámetros clave

                • Field ID: el identificador del campo personalizado que se renombra.
                • Label: la nueva etiqueta del campo personalizado, la que se mostrará después en ConvertKit.
                Casos de uso
                un campo llamado Source pasa a llamarse Acquisition Source en toda la cuenta, en una sola ejecución y no a mano desde la interfaz.

                Form

                3 operaciones
                05

                Add a subscriber

                form.addSubscriber

                Lo que ves en n8n

                Notas y casos de uso

                Mete una dirección de correo en un formulario de ConvertKit, que es como alguien entra en la lista desde fuera. El formulario elegido manda en lo que ocurre después.

                Parámetros clave

                • Form Name or ID: el formulario de destino, tomado de la lista que carga n8n o indicado como identificador con una expresión.
                • Email: la dirección de correo del suscriptor, con la forma name@email.com.
                • First Name y Custom Fields, dentro de Additional Fields: pares de clave y valor que viajan con el suscriptor. El campo personalizado tiene que existir antes de usarlo aquí.
                Casos de uso
                una página de inscripción a un webinar en tu dominio manda los datos a n8n, que coloca a cada asistente en el formulario correspondiente.
                06

                Get many forms

                form.getAll

                Lo que ves en n8n

                Notas y casos de uso

                Devuelve los formularios que existen en la cuenta. Sirve cuando un flujo tiene que elegir el formulario por su nombre durante la ejecución, en vez de llevar uno fijo dentro del nodo.

                Parámetros clave

                • Return All: activado para un inventario completo de los formularios; desactivado, Limit fija cuántos vuelven como máximo.
                Casos de uso
                una revisión mensual lista todos los formularios y señala los que ya no aparecen en ninguna página de la web.
                07

                Get all subscriptions

                form.getSubscriptions

                Lo que ves en n8n

                Notas y casos de uso

                Lista las suscripciones a un formulario con los datos del suscriptor de cada una. Es la vista de captación: por aquí se ve quién entró por ese formulario concreto.

                Parámetros clave

                • Form Name or ID: el formulario cuyas suscripciones quieres leer.
                • Subscriber State, dentro de Additional Fields: active o cancelled, para separar a quien sigue de quien se fue.
                • Return All: activado para todo el histórico del formulario; desactivado, Limit corta antes la lectura.
                Casos de uso
                un informe de captación compara mes a mes el formulario de la página de precios con el del blog.

                Sequence

                3 operaciones
                08

                Add a subscriber

                sequence.addSubscriber

                Lo que ves en n8n

                Notas y casos de uso

                Coloca a alguien directamente en una secuencia, de manera que los correos salen en el orden configurado en ConvertKit. A diferencia de la vía del formulario, aquí el destino es la serie automatizada.

                Parámetros clave

                • Sequence Name or ID: la secuencia en la que inscribir a la persona.
                • Email: la dirección de correo del suscriptor, con la forma name@email.com.
                • Tag Names or IDs, First Name y Custom Fields, dentro de Additional Fields: etiquetas y valores aplicados en el mismo momento, lo que evita una segunda operación detrás.
                Casos de uso
                quien compra entra en la secuencia de bienvenida en cuanto el evento de compra llega a n8n, ya etiquetado como cliente.
                09

                Get many sequences

                sequence.getAll

                Lo que ves en n8n

                Notas y casos de uso

                Relee las secuencias configuradas en la cuenta, con el identificador de cada una. Es la comprobación previa a que un flujo intente inscribir a nadie, para que una secuencia renombrada no rompa lo que viene después.

                Parámetros clave

                • Return All: activado para listar todas las secuencias; desactivado, Limit decide cuántas vuelven.
                Casos de uso
                una herramienta interna muestra las secuencias vigentes en un desplegable y un compañero elige una sin abrir ConvertKit.
                10

                Get all subscriptions to a sequence

                sequence.getSubscriptions

                Lo que ves en n8n

                Notas y casos de uso

                Devuelve a todos los suscriptores de una secuencia, con sus datos incluidos. Si la versión de formulario responde por dónde entraron, esta responde quién está recorriendo la serie ahora mismo.

                Parámetros clave

                • Sequence Name or ID: la secuencia que se lee.
                • Subscriber State, dentro de Additional Fields: active para quienes siguen dentro, cancelled para estudiar las salidas.
                • Return All: activado para recorrer la secuencia entera; desactivado, Limit pone tope al resultado.
                Casos de uso
                una exportación semanal vuelca la secuencia de bienvenida en una hoja que el equipo de soporte ya vigila.

                Tag

                2 operaciones
                11

                Create a tag

                tag.create

                Lo que ves en n8n

                Notas y casos de uso

                Añade una etiqueta a la cuenta de ConvertKit para que los suscriptores puedan llevarla luego. Crear la etiqueta y ponerla son dos pasos distintos.

                Parámetros clave

                • Name: el nombre de la etiqueta. Se pueden crear varias de golpe separando los nombres con una coma.
                Casos de uso
                el lanzamiento de un producto crea todo su juego de etiquetas en una ejecución, lista de espera, comprador y reembolso incluidos, antes de la primera campaña.
                12

                Get many tags

                tag.getAll

                Lo que ves en n8n

                Notas y casos de uso

                Trae las etiquetas que existen en la cuenta. La mayoría la usa para evitar un casi duplicado, porque toda cuenta de ConvertKit acaba con tres grafías de la misma idea.

                Parámetros clave

                • Return All: activado para recuperar la lista completa de etiquetas; desactivado, Limit fija el máximo devuelto.
                Casos de uso
                antes de crear una etiqueta, un flujo revisa los nombres existentes y reutiliza uno cuando el texto se parece bastante.

                Tag Subscriber

                3 operaciones
                13

                Add a tag to a subscriber

                tagSubscriber.add

                Lo que ves en n8n

                Notas y casos de uso

                Aplica una etiqueta ya existente a una persona, identificada por su dirección de correo. Es la pieza de segmentación: buena parte de la lógica posterior en ConvertKit se apoya en las etiquetas.

                Parámetros clave

                • Tag Name or ID: la etiqueta que se aplica, desde la lista cargada o mediante una expresión.
                • Email: la dirección de correo del suscriptor, con la forma name@email.com.
                • First Name y Custom Fields, dentro de Additional Fields: valores escritos en el suscriptor a la vez, con el campo personalizado creado de antemano.
                Casos de uso
                un ticket de soporte marcado como riesgo de baja etiqueta a la persona y la siguiente campaña la deja fuera.
                14

                Get many tag subscriptions

                tagSubscriber.getAll

                Lo que ves en n8n

                Notas y casos de uso

                Aquí sale todo el que lleva una etiqueta concreta, con los datos del suscriptor detrás de cada suscripción. En la práctica, así es como un segmento se convierte en una lista de personas utilizable fuera de ConvertKit.

                Parámetros clave

                • Tag Name or ID: la etiqueta cuyos suscriptores quieres.
                • Subscriber State, dentro de Additional Fields: active o cancelled, según si el segmento sirve para enviar o para analizar.
                • Return All: activado para el segmento entero; desactivado, Limit lo recorta.
                Casos de uso
                la etiqueta del webinar se convierte en un fichero de audiencia para una plataforma de anuncios, actualizado la mañana de la sesión.
                15

                Delete a tag from a subscriber

                tagSubscriber.delete

                Lo que ves en n8n

                Notas y casos de uso

                Quita una etiqueta de un solo suscriptor sin tocar la etiqueta en sí, que sigue disponible para el resto de contactos de la cuenta.

                Parámetros clave

                • Tag Name or ID: la etiqueta que se retira de esa persona.
                • Email: la dirección de correo del suscriptor, con la forma name@email.com.
                Casos de uso
                quien estaba de prueba y pasa a pagar pierde la etiqueta de prueba en el mismo flujo que le da la de cliente, para que ninguna campaña lo trate como las dos cosas a la vez.
                Necesitas ayuda

                ¿Necesitas ayuda para automatizar ConvertKit con n8n?

                El equipo te responde directamente.

                Cada mensaje lo lee una persona.

                FAQ

                ConvertKit y n8n, las dudas que vienen después

                01¿La integración ConvertKit n8n es gratuita?
                Sí por el lado de n8n. El nodo ConvertKit y el ConvertKit Trigger vienen incluidos con n8n, así que no hay nada que instalar ni ningún coste extra por el conector. Vale igual en n8n Cloud, la oferta alojada por n8n, que en una instancia autoalojada instalada con Docker o npm, en Community Edition bajo licencia Sustainable Use. Un flujo se comporta igual en los dos sitios, de modo que puedes probar en Cloud y mover el trabajo más tarde. Lo que cuesta la cuenta de ConvertKit es otra cuestión y esta página no la trata.
                02¿Qué credenciales hacen falta para conectar ConvertKit con n8n?
                Una clave de API y nada más. ConvertKit admite autenticación por clave de API para estos nodos, y la clave está en tu cuenta, dentro de los ajustes, en la sección Advanced. En n8n creas una credencial ConvertKit y pegas ese valor en el campo llamado API Secret. La misma credencial autentica el nodo ConvertKit y el ConvertKit Trigger, y una vez guardada se reutiliza en todos los flujos de la instancia en lugar de teclearla otra vez. Para comprobarlo en segundos, abre un selector Form Name or ID y mira si aparecen tus formularios reales.
                03¿Qué límites tiene el nodo ConvertKit en n8n?
                Depende de lo que busques más allá del catálogo. El nodo expone 15 operaciones sobre 5 recursos, y todo lo que queda fuera de esa lista se alcanza con el nodo HTTP Request, que llama a cualquier endpoint de la API de ConvertKit reutilizando la misma credencial mediante la autenticación predefinida. Dos detalles pesan más en el día a día. Las operaciones de lectura devuelven la primera página mientras Return All siga desactivado, y en ese caso Limit fija el número máximo de elementos. Además, un campo personalizado debe existir en la cuenta antes de que una operación de suscriptor pueda escribir en él, y un campo obligatorio vacío detiene la ejecución del nodo.
                04¿El ConvertKit Trigger reacciona en tiempo real?
                Sí, funciona con webhook. Al activar el flujo, n8n registra en ConvertKit una URL de webhook, es decir una dirección a la que ConvertKit llama cada vez que ocurre el evento elegido. El aviso llega a tu flujo en cuestión de segundos, sin bucle de polling y sin intervalo que ajustar. El evento se elige en el parámetro Event y, según cuál sea, el nodo pide su alcance: un Form Name or ID, un Sequence Name or ID, un Tag Name or ID, un Initiating Link o un Product ID. En total hay diez eventos disponibles.
                05¿n8n o Make para automatizar ConvertKit?
                Depende de cuatro criterios. Ninguna de las dos gana en todos. El alojamiento manda primero: n8n corre en tu propio servidor con Docker o npm, o en n8n Cloud, mientras que Make existe solo en versión alojada. De ahí sale el control de los datos, porque una instancia autoalojada guarda los correos de tus suscriptores dentro de tu infraestructura. Luego el coste. Make factura por operación, algo que conviene simular contra un flujo que recorre la exportación completa de una etiqueta. Queda la lógica visual: las dos son editoras visuales y la que tu equipo vaya a mantener de verdad es la buena. La reseña de n8n enlazada arriba entra en el detalle.