Recursos · Integración n8n

Integración Notion n8nAutomatiza Notion con n8n.

Una ficha de candidatura o un acta de reunión se crean solas desde tus flujos. La integración Notion n8n reúne 14 operaciones en 5 recursos: bases, páginas de base, páginas, bloques y usuarios. El Notion Trigger vigila una base y arranca el flujo con sus 2 eventos. Para quien documenta en Notion.

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

Por qué automatizar

¿Qué resuelve la integración Notion n8n?

La integración Notion n8n conecta tu workspace con los flujos de trabajo de n8n en los dos sentidos: el nodo Notion ejecuta 14 operaciones sobre bases, páginas, bloques y usuarios, y el Notion Trigger, el nodo que pone en marcha un flujo, reacciona cuando se añade o se actualiza una página en la base que vigilas. Todo pasa por una integración de Notion que creas tú y a la que das acceso página por página.

Las actas de reunión dejan de escribirse a mano. El flujo recoge la transcripción, abre la página con page.create bajo la página del proyecto y va apilando el resumen en bloques con block.append. El aviso sale después hacia Slack con el enlace de la página recién creada.

Las candidaturas entran solas en la base de contratación. El correo llega a Gmail, el flujo extrae los datos del CV y crea la ficha con databasePage.create, con el puesto y la puntuación ya rellenados en las propiedades. Cuando el candidato avanza de fase, databasePage.update mueve el estado sin que nadie abra Notion.

El informe semanal sale de la base, no de un copiar y pegar. databasePage.getAll recorre las páginas con Return All activado, el flujo se queda con lo que interesa y vuelca las filas en Google Sheets. El mismo patrón sirve para replicar un roadmap de Notion en Clickup y que cada equipo trabaje donde prefiera.

Hay dos casos en los que el nodo se queda corto y toca pasar al nodo HTTP Request, que llama a cualquier endpoint de la API de Notion, la vía por la que un programa habla con Notion sin abrir la interfaz, reutilizando esa misma credencial con la autenticación predefinida. Las relaciones de un solo sentido no se ven ni se filtran desde el recurso Database Page, solo las de doble sentido, así que actualizarlas pide un PATCH a la URL de páginas de la API seguida del identificador. Los encabezados desplegables tampoco están soportados: el nodo crea el encabezado y una llamada extra le añade la propiedad is_toggleable.

Los límites que conviene conocer antes de montar nada: las lecturas paginan con Return All y Limit, los campos vacíos o nulos que llegan de un nodo anterior provocan un error de validación en Notion, y la integración solo ve las páginas que le has compartido una a una. Si todavía estás eligiendo herramienta, la Reseña n8n entra en el detalle, y el Curso n8n cubre el montaje de los primeros flujos.

Conexión

¿Cómo conectar Notion con n8n?

  1. 01

    Crea la integración en Notion

    Hace falta una cuenta de Notion con acceso de administrador. En el panel de integraciones, pulsa + New integration, pon un Name como n8n integration y valida con Submit. En la pestaña Capabilities, marca Read content, Update content, Insert content y User information without email addresses, y guarda.

  2. 02

    Pega el secreto en la credencial de n8n

    La pestaña Secrets muestra el Internal Integration Token: cópialo en el campo Internal Integration Secret de la credencial de n8n, que se crea una sola vez en el menú Credentials y se reutiliza en todos tus flujos. Si prefieres OAuth2, la credencial pide Client ID y Client Secret, y la integración tiene que estar en distribución pública.

  3. 03

    Comparte las páginas con la integración

    Una integración recién creada no ve nada. Abre la página o la base en Notion, despliega el menú de los tres puntos arriba a la derecha, entra en Connections, elige Connect to y busca tu integración en la lista. Mientras no compartas al menos una página, cada petición responde con un error. Repite el gesto en cada base que vayan a tocar tus flujos.

Disparadores

¿Qué pone en marcha el Notion Trigger?

Notion Trigger es el nodo que arranca un workflow cuando algo ocurre en Notion. Escucha 2 eventos, listados abajo por familia. Eliges uno o varios, activas el workflow y n8n registra el webhook (la URL que Notion 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.

page.*1
    paged.*1

      Notas de configuración

      01Notion TriggerEl Notion Trigger es el nodo de entrada: un trigger, en n8n, es el nodo que decide cuándo se ejecuta todo lo demás. Funciona por polling, o sea que n8n pregunta cada cierto tiempo a la API de Notion si ha pasado algo en la base vigilada: el intervalo se elige en «Poll Times» y baja como mucho a cada minuto. Del lado de Notion no hay ningún webhook que registrar, ninguna URL a la que Notion tenga que llamar, y a cambio la detección tarda lo que dure ese intervalo.

      El Notion Trigger es el nodo de entrada: un trigger, en n8n, es el nodo que decide cuándo se ejecuta todo lo demás. Funciona por polling, o sea que n8n pregunta cada cierto tiempo a la API de Notion si ha pasado algo en la base vigilada: el intervalo se elige en «Poll Times» y baja como mucho a cada minuto. Del lado de Notion no hay ningún webhook que registrar, ninguna URL a la que Notion tenga que llamar, y a cambio la detección tarda lo que dure ese intervalo.

      Parámetros clave

      • Database: la base vigilada, obligatoria. Se elige en la lista que carga n8n con las bases compartidas con tu integración, o se rellena con una expresión, el valor calculado sobre la marcha del tipo {{ $json.id }}; vacía, bloquea la ejecución del nodo.
      • Simplify: activado, n8n devuelve una versión reducida de la respuesta en lugar de los datos en bruto. Viene bien de entrada, porque las propiedades de Notion llegan muy anidadas.
      Cuándo usarlo
      cuando la base de Notion sea el punto de partida del flujo y no su destino. Un nodo vigila una sola base, así que dos bases piden dos triggers.
      02Page Added to DatabasePrimer evento del nodo, con el valor pageAddedToDatabase. Se dispara cuando aparece una página nueva en la base vigilada, la haya creado alguien del equipo a mano o un flujo con databasePage.create. El flujo arranca con esa página y sus propiedades ya en la mano, así que no hace falta volver a leerla para trabajar con ella.

      Primer evento del nodo, con el valor pageAddedToDatabase. Se dispara cuando aparece una página nueva en la base vigilada, la haya creado alguien del equipo a mano o un flujo con databasePage.create. El flujo arranca con esa página y sus propiedades ya en la mano, así que no hace falta volver a leerla para trabajar con ella.

      Casos de uso
      una solicitud interna cae en la base de peticiones y el flujo avisa al responsable con la ficha enlazada. Una idea nueva en la base editorial y el flujo prepara el borrador del brief con block.append, con las secciones ya puestas y el responsable asignado.
      Cuándo usarlo
      para todo lo que sea recepción: la base hace de bandeja de entrada y cada línea nueva pone en marcha un proceso, sin que nadie tenga que avisar de que ha llegado algo.
      03Page Updated in DatabaseSegundo evento, con el valor pagedUpdatedInDatabase. Aquí el flujo no espera una línea nueva sino un cambio en una página que ya estaba: un estado que avanza, una fecha que se mueve, un responsable que cambia.

      Segundo evento, con el valor pagedUpdatedInDatabase. Aquí el flujo no espera una línea nueva sino un cambio en una página que ya estaba: un estado que avanza, una fecha que se mueve, un responsable que cambia.

      Parámetros clave

      • Database: el evento se limita a la base seleccionada. No hay ningún parámetro para escuchar una sola propiedad, los únicos ajustes del nodo son esa base y Simplify, así que el filtro fino se monta después, dentro del flujo.
      Casos de uso
      una tarea pasa a Listo y el flujo recupera la ficha con databasePage.get para comprobar el resto de propiedades antes de facturar o de cerrar el ticket.
      Cuándo usarlo
      cuando lo que importa no es la creación sino el recorrido de la ficha, de un estado al siguiente, y quieres que cada etapa dispare su propio automatismo.
      Acciones

      Las 14 operaciones del nodo Notion en n8n

      El nodo Notion expone 14 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
      RecursoCreateGetGet Child BlocksUpdateAppend AfterArchiveSearch
      Block
      Database
      Database Page
      Page
      User

      Block

      2 operaciones
      01

      Append a block

      block.append

      Lo que ves en n8n

      Notas y casos de uso

      Añade uno o varios bloques al final de un bloque o de una página que ya existe, sin tocar lo que había encima. Es la operación que rellena una página creada un paso antes.

      Parámetros clave

      • Block: el bloque o la página de destino, elegido en la lista o pasado con una expresión como {{ $json.id }} desde el nodo anterior.
      • Blocks: el contenido que se añade, pieza a pieza con el botón Add Block.
      Casos de uso
      volcar el resumen de una reunión bajo la página del cliente, o ir apilando las líneas de un informe diario en la misma página en lugar de crear una nueva cada mañana.
      02

      Get many child blocks

      block.getAll

      Lo que ves en n8n

      Notas y casos de uso

      Devuelve los bloques hijos de un bloque o de una página, o sea su contenido tal y como está estructurado en Notion. Es la vía para leer una página entera desde un flujo.

      Parámetros clave

      • Block: el bloque o la página de la que se leen los hijos.
      • Return All: marcado, bajan todos los bloques; sin marcar, la lectura se detiene en el número fijado en Limit.
      • Also Fetch Nested Blocks: recupera también los bloques metidos dentro de otros, no solo el primer nivel.
      Casos de uso
      pasar el contenido de una página a un modelo de IA para resumirlo, o verificar que una plantilla de página tiene todas sus secciones antes de enviarla al cliente.

      Database

      3 operaciones
      03

      Get a database

      database.get

      Lo que ves en n8n

      Notas y casos de uso

      Lee la ficha de una base concreta: cómo se llama y qué propiedades tiene. No devuelve las páginas que contiene, solo su estructura.

      Parámetros clave

      • Database: la base cuya ficha se consulta.
      • Simplify: deja la respuesta en su versión reducida, más cómoda de leer que los datos en bruto cuando la base tiene muchas propiedades.
      Casos de uso
      leer los nombres exactos de las propiedades antes de escribir en la base, o comprobar que la integración sigue teniendo acceso después de un cambio de permisos.
      04

      Get many databases

      database.getAll

      Lo que ves en n8n

      Notas y casos de uso

      Lista las bases a las que tu integración llega. El resultado refleja lo que le has compartido: lo que no está compartido no sale por ningún lado.

      Parámetros clave

      • Return All: sin él, la lista se corta en Limit, que es justo lo que no quieres en un inventario.
      • Simplify: reduce cada base a lo esencial, suficiente para recuperar su identificador.
      Casos de uso
      auditar qué bases ve la integración después de una limpieza de permisos, o construir sobre la marcha la lista de bases que el resto del flujo va a recorrer.

      Database Page

      4 operaciones
      06

      Create a database page

      databasePage.create

      Lo que ves en n8n

      Notas y casos de uso

      Crea una página dentro de una base, o sea una línea con sus propiedades ya rellenadas. Convierte en ficha de Notion un dato que llega de otro sitio.

      Parámetros clave

      • Database: la base donde aterriza la ficha.
      • Title: el título de la página, el que encuentra Quick Find.
      • Properties: cada propiedad se añade con Add Property según su tipo, con Option Names or IDs para una selección múltiple y Date Start y Date End para un rango.
      • Blocks: el cuerpo de la página, opcional, con la plantilla ya escrita.
      Casos de uso
      cada pedido recibido se convierte en ficha de seguimiento con su fecha de entrega, y el equipo trabaja sobre la base.
      07

      Get a database page

      databasePage.get

      Lo que ves en n8n

      Notas y casos de uso

      Trae una sola página de base a partir de su identificador, con todas sus propiedades. Es el paso de lectura antes de decidir qué hacer con ella.

      Parámetros clave

      • Database Page: la página que se recupera, señalada en la lista o con el identificador que trae el nodo anterior.
      • Simplify: aplana la respuesta, cómodo cuando solo necesitas dos o tres propiedades.
      Casos de uso
      releer el estado actual de una ficha antes de actualizarla, para no pisar un cambio que alguien acaba de hacer a mano en Notion.
      08

      Get many database pages

      databasePage.getAll

      Lo que ves en n8n

      Notas y casos de uso

      Recorre las páginas de una base y devuelve las que pasan el filtro. Es la operación de los exports y de los informes.

      Parámetros clave

      • Database: la base que se recorre.
      • Filter: None para traerlo todo, Build Manually para montar las condiciones en la interfaz, JSON para pegar el filtro ya escrito.
      • Must Match: con Any filter basta una condición, con All Filters tienen que cumplirse todas.
      • Return All: si se queda sin marcar, el informe sale cortado en Limit y nadie se da cuenta hasta el final.
      Casos de uso
      sacar cada lunes las tareas cerradas de la semana para el informe, o recuperar las fichas con Download Files cuando la base guarda adjuntos.
      09

      Update a database page

      databasePage.update

      Lo que ves en n8n

      Notas y casos de uso

      Actualiza las propiedades de una ficha que ya existe. La página se señala una vez y solo cambia lo que le indiques, el resto queda intacto.

      Parámetros clave

      • Database Page: la ficha que se modifica.
      • Properties: las propiedades que cambian, añadidas una a una con Add Property.
      • Ignore If Empty: evita machacar un valor existente cuando el dato que llega del nodo anterior viene vacío, que es el error clásico de las actualizaciones automáticas.
      Casos de uso
      mover una tarea de estado cuando el pago entra, marcar la casilla de validación al terminar el flujo o escribir la fecha real de entrega en la ficha.

      Page

      3 operaciones
      10

      Archive a page

      page.archive

      Lo que ves en n8n

      Notas y casos de uso

      Archiva una página: desaparece de la vista activa de Notion sin borrarse del todo. Es la forma limpia de cerrar una ficha desde un flujo.

      Parámetros clave

      • Page: la página que se archiva.
      • Simplify: devuelve la confirmación reducida, suficiente para registrar en el log qué página se ha archivado.
      Casos de uso
      vaciar la base de pruebas al final de un flujo de prueba, o archivar las fichas cerradas hace más de un trimestre para que la vista de trabajo siga siendo legible.
      11

      Create a page

      page.create

      Lo que ves en n8n

      Notas y casos de uso

      Genera una página hija debajo de otra página, fuera de cualquier base. Es lo que usas para las actas, las notas y los documentos que no son fichas.

      Parámetros clave

      • Parent Page: la página padre bajo la que cuelga la nueva.
      • Title: obligatorio aquí, al contrario que en una página de base.
      • Blocks: el contenido inicial, escrito de una vez en lugar de encadenar una segunda llamada.
      • Icon: en Options, un emoji o la URL de un archivo según el Icon Type elegido.
      Casos de uso
      crear el acta de cada reunión bajo la página del proyecto, con el orden del día ya escrito y el icono que usa el equipo para las actas.

      User

      2 operaciones
      13

      Get a user

      user.get

      Lo que ves en n8n

      Notas y casos de uso

      Consulta un usuario del workspace a partir de su identificador y devuelve su ficha. Traduce el identificador que aparece en las propiedades de tipo persona.

      Parámetros clave

      • User ID: el identificador del usuario, obligatorio, tal y como lo devuelve una página de base en su propiedad de personas.
      Casos de uso
      poner el nombre del responsable en el mensaje de aviso en vez de un identificador ilegible, o comprobar a quién se ha asignado una tarea antes de escalarla.
      14

      Get many users

      user.getAll

      Lo que ves en n8n

      Notas y casos de uso

      Enumera los usuarios del workspace a los que alcanza la integración. Con la capacidad User information without email addresses marcada, las fichas llegan sin correo.

      Parámetros clave

      • Return All: recupera la lista entera, útil en un workspace donde nadie sabe ya quién sigue dentro.
      • Limit: corta la lista cuando solo quieres una muestra para probar el flujo.
      Casos de uso
      montar al principio del flujo una tabla de correspondencia entre identificadores y nombres, para no llamar a Notion una vez por ficha.
      Necesitas ayuda

      ¿Necesitas ayuda para automatizar Notion con n8n?

      El equipo te responde directamente.

      Cada mensaje lo lee una persona.

      FAQ

      Preguntas frecuentes

      01¿La integración Notion n8n es gratuita?
      Sí. El nodo Notion y el Notion Trigger vienen incluidos en n8n: nada que instalar y ningún coste extra por el lado de n8n, ni en n8n Cloud, la oferta alojada por n8n, ni en una instancia que alojes tú con Docker o npm, en Community Edition y su licencia Sustainable Use. El flujo es el mismo en los dos casos. Las 14 operaciones y los 2 eventos están disponibles desde el primer flujo, sin complemento que comprar. Del lado de Notion, solo hace falta una cuenta con acceso de administrador, que es lo que permite crear la integración y generar el token. Lo que cueste tu plan de Notion no se trata aquí.
      02¿Qué credenciales y permisos hacen falta?
      Hay dos métodos. El token de integración interna, pensado para un solo workspace: creas la integración en Notion, copias el Internal Integration Token de la pestaña Secrets y lo pegas en el campo Internal Integration Secret de la credencial de n8n. O OAuth2, para una integración pública repartida entre varios workspaces, que pide Client ID y Client Secret, la OAuth Redirect URL de n8n declarada como Redirect URI y una revisión de seguridad por parte de Notion. En los dos casos hay que marcar las capacidades Read content, Update content, Insert content y User information without email addresses, y compartir con la integración cada página o base que el flujo vaya a tocar.
      03¿Qué límites tiene el nodo Notion?
      Tres, sobre todo. Las relaciones: el recurso Database Page solo muestra y filtra las de doble sentido, así que una relación de un solo sentido obliga a lanzar un PATCH a la URL de páginas de la API de Notion desde el nodo HTTP Request, que reutiliza esa credencial con la autenticación predefinida. Los encabezados desplegables: el nodo crea encabezados normales y hace falta una llamada extra para activar la propiedad is_toggleable. Y los valores vacíos o nulos que vienen de un nodo anterior provocan un error de validación, que se esquiva con un nodo If o con un valor por defecto. En las lecturas largas, acuérdate de Return All: encadena las páginas de la API, y sin marcarlo la respuesta se corta en Limit.
      04¿El Notion Trigger reacciona en tiempo real?
      No. El Notion Trigger funciona por polling: n8n consulta la API de Notion al ritmo que fijas en «Poll Times», como mucho cada minuto, y el retraso entre el cambio en la base y el arranque del flujo vale justo ese intervalo. Del lado de Notion no hay ningún webhook que crear ni nada que configurar. Los 2 eventos disponibles cubren la página añadida y la página actualizada dentro de la base vigilada. Los únicos ajustes del nodo son esa base y Simplify: no hay manera de escuchar solo una propiedad concreta, así que si el flujo debe reaccionar a un cambio de estado en particular, el filtro se pone justo después, con un nodo If que compara el valor recibido.
      05¿n8n o Make para Notion?
      Depende de dónde quieras que vivan tus flujos y tus datos. Make es una plataforma alojada, sin opción de instalarla en tu propio servidor, y se factura por operación: cuantas más páginas de Notion recorras, más sube la cuenta. n8n se aloja donde tú decidas o se usa en su versión Cloud, con el mismo flujo en los dos casos, y para Notion trae 14 operaciones sobre 5 recursos más los 2 eventos del trigger, con HTTP Request como salida para lo que falte. La lógica visual también se lee distinto en cada una: monta el mismo caso en las dos y quédate con la que tu equipo entienda sin manual.
      Hack'celeration Lab

      Recibe nuestros tips de integración cada semana.

      Sin spam. Cancela cuando quieras.