Saltar al contenido principal
El Toolkit de Notion permite a agentes y flujos de trabajo interactuar con páginas y bases de datos de Notion. Soporta búsqueda de contenido, consulta y actualización de registros de bases de datos, lectura y anexión de contenido de páginas, y creación de nuevas páginas.

​
Prerrequisitos

  • Una cuenta de Notion (el plan gratuito es suficiente)
  • Un espacio de trabajo de Notion (cada cuenta tiene uno por defecto)

​
Crear una Conexión

  1. En el flujo de trabajo, agregue un paso del toolkit de Notion.
  2. Haga clic en Conectar con Notion.
  3. Autorice la conexión en la pantalla de consentimiento de Notion y seleccione qué páginas y bases de datos otorgar acceso.
El toolkit solo puede acceder a páginas y bases de datos que hayan sido compartidas explícitamente con la conexión. Para compartir contenido, abra la página o base de datos en Notion, haga clic en ··· → Conexiones, y agregue su integración. El contenido en el mismo espacio de trabajo que no haya sido compartido no es visible.

​
Herramientas Disponibles

HerramientaDescripción
BuscarBusque en todas las páginas y bases de datos compartidas por título
Listar Bases de DatosDevuelva todas las bases de datos a las que puede acceder la conexión
Obtener Base de DatosDevuelva el esquema (nombres de columnas y tipos) de una base de datos específica
Consultar Base de DatosRecupere registros de una base de datos con filtros y ordenamiento opcionales
Obtener PáginaRecupere los valores de propiedad y metadatos de una página o registro de base de datos
Crear PáginaCree un nuevo registro de base de datos o sub-página
Actualizar PáginaActualice propiedades de una página existente, o archívela
Obtener Contenido de PáginaLea el texto del cuerpo (bloques de contenido) de una página
Agregar ContenidoAgregue nuevos bloques de contenido al final de una página

​
Buscar

Busca en todas las páginas y bases de datos compartidas, devolviendo coincidencias por título. Entradas principales:
EntradaDescripción
ConsultaEl texto a buscar
Tipo de FiltroOpcionalmente restrinja a page o database. Deje en blanco para buscar ambos.
Tamaño de PáginaNúmero de resultados a devolver (predeterminado: 10, máximo: 100)
Referencia de resultados en pasos posteriores:
  • ID del primer resultado: {{ step.output.results[0].id }}
Ejemplo de caso de uso: Antes de crear un nuevo registro de cliente, busque por el nombre del cliente. Si count es mayor a 0, el cliente ya existe — use el id del registro existente en lugar de crear un duplicado.

​
Acciones de Base de Datos

​
Listar Bases de Datos

Devuelve todas las bases de datos a las que puede acceder la conexión, con sus nombres e IDs. Entradas principales:
EntradaDescripción
Tamaño de PáginaNúmero de bases de datos a devolver (predeterminado: 20, máximo: 100)
Cuándo usarlo: Ejecute esto una vez en un flujo de trabajo de prueba para descubrir sus IDs de base de datos. Copie el id de la base de datos que desee y códíguelo de forma fija en pasos posteriores.

​
Obtener Base de Datos

Devuelve el esquema de una base de datos específica — sus nombres de columnas y tipos de propiedad. Entradas principales:
EntradaDescripción
ID de Base de DatosEl ID de la base de datos — de Listar Bases de Datos, o de la URL de Notion: el segmento antes del ?v=
Cuándo usarlo: Ejecute esto antes de escribir pasos de Crear Página o Actualizar Página. Le indica los nombres exactos de las propiedades (distingue mayúsculas) y sus tipos, lo que determina el formato JSON a usar en el campo Propiedades.
Obtener Base de Datos muestra tipos y nombres de propiedades pero no los valores de opciones disponibles para campos de Selección. Para ver las opciones de selección válidas, abra la base de datos directamente en Notion.

​
Consultar Base de Datos

Recupera registros de una base de datos con filtrado y ordenamiento opcionales. Entradas principales:
EntradaDescripción
ID de Base de DatosQué base de datos consultar
FiltroUn objeto de filtro JSON (vea ejemplos más abajo). Deje en blanco para devolver todos los registros.
OrdenamientosUn arreglo JSON de reglas de ordenamiento (vea ejemplos más abajo)
Tamaño de PáginaNúmero de registros a devolver (predeterminado: 20, máximo: 100)
Ejemplos de filtro: Filtro simple — registros donde Estado es igual a “En Progreso”: 
{
  "property": "Status",
  "select": { "equals": "In Progress" }
}
Filtro por casilla de verificación: 
{
  "property": "Done",
  "checkbox": { "equals": false }
}
Filtro por fecha — registros con Fecha Límite antes de una fecha específica: 
{
  "property": "Due Date",
  "date": { "before": "2026-05-26" }
}
Filtro combinado con lógica AND: 
{
  "and": [
    { "property": "Status", "select": { "equals": "In Progress" } },
    { "property": "Done", "checkbox": { "equals": false } }
  ]
}
Ordenamiento — más reciente primero: 
[
  { "property": "Created time", "direction": "descending" }
]
Referencia de resultados en pasos posteriores:
  • ID del primer resultado: {{ step.output.results[0].id }}
  • Estado del primer resultado: {{ step.output.results[0].properties.Status }}
  • Título del primer resultado: {{ step.output.results[0].title }}

​
Acciones de Página

​
Obtener Página

Recupera los valores de propiedad y metadatos de una página o registro de base de datos específica. Entradas principales:
EntradaDescripción
ID de PáginaEl ID de la página — de la URL de Notion, o de los resultados de Consultar Base de Datos o Buscar
Referencia de valores en pasos posteriores:
  • Estado: {{ step.output.page.properties.Status }}
  • Título: {{ step.output.page.title }}
  • ID de Página: {{ step.output.page.id }}
Ejemplo de caso de uso: Un activador se dispara con un ID de página. Use Obtener Página para leer el Estado actual del registro. Si el Estado es “Pendiente”, continúe el flujo de trabajo — de lo contrario deténgase.

​
Crear Página

Crea una nueva página — ya sea como un registro dentro de una base de datos (nueva fila) o como una sub-página bajo otra página. Entradas principales:
EntradaDescripción
ID PadreEl ID de la base de datos (para una nueva fila) o ID de página (para una sub-página)
Tipo Padredatabase_id para agregar una fila de base de datos, page_id para agregar una sub-página. Predeterminado: database_id
TítuloEl título de la página o registro como texto plano
PropiedadesObjeto JSON opcional para valores de campos adicionales. Las claves deben coincidir exactamente con los nombres de propiedad de su base de datos — use Obtener Base de Datos para confirmarlos.
Formato de Propiedades por tipo de campo: 
// Campo de Selección
{ "Status": { "select": { "name": "To Do" } } }

// Campo de Estado (tipo de estado integrado de Notion)
{ "Status": { "status": { "name": "In Progress" } } }

// Campo de Fecha
{ "Due Date": { "date": { "start": "2026-06-01" } } }

// Campo de Casilla
{ "Done": { "checkbox": false } }

// Campo Numérico
{ "Priority Score": { "number": 8 } }

// Campo de Texto Enriquecido
{ "Notes": { "rich_text": [{ "text": { "content": "Needs review before sending." } }] } }
Ejemplo completo — creación de una fila de tarea: Título: Seguimiento con cliente Propiedades: 
{
  "Status": { "select": { "name": "To Do" } },
  "Due Date": { "date": { "start": "2026-06-01" } },
  "Done": { "checkbox": false }
}
El id devuelto puede pasarse a pasos posteriores para actualizar o enlazar a la nueva página.

​
Actualizar Página

Actualiza las propiedades de una página existente, o la archiva. Entradas principales:
EntradaDescripción
ID de PáginaLa página a actualizar — de Consultar Base de Datos, Obtener Página o Buscar
PropiedadesObjeto JSON con solo los campos que desea cambiar (mismo formato que Crear Página). Los campos no incluidos se mantienen sin cambios.
ArchivadaEstablezca en true para archivar (eliminar suavemente) la página
Ejemplo — marcar una tarea como completada: 
{
  "Status": { "select": { "name": "Done" } },
  "Done": { "checkbox": true },
  "Completed On": { "date": { "start": "2026-05-26" } }
}
Ejemplo — archivar un registro: Deje Propiedades vacías y establezca Archivada en true. El registro desaparece de la vista de la base de datos pero puede restaurarse desde la papelera de Notion. Patrón típico:
  1. Use Consultar Base de Datos para encontrar el registro y obtener su id
  2. Pase ese id a Actualizar Página para cambiar sus campos

​
Acciones de Contenido

​
Obtener Contenido de Página

Recupera los bloques de contenido dentro de una página de Notion — párrafos, encabezados, listas con viñetas, etc. Esto es separado de las propiedades de la página (campos de base de datos). Use esto para leer el texto del cuerpo de un documento. Entradas principales:
EntradaDescripción
ID de PáginaLa página de la cual leer contenido
Tamaño de PáginaNúmero de bloques a devolver (predeterminado: 50, máximo: 100)
Referencia de valores en pasos posteriores:
  • Texto del primer bloque: {{ step.output.blocks[0].text }}
  • Todos los bloques: {{ step.output.blocks }}
Ejemplo de caso de uso: Obtenga el contenido de la página, pase todos los bloques de texto a un paso de IA para generar un resumen, luego envíe ese resumen por correo electrónico o Telegram.

​
Agregar Contenido

Agrega nuevos bloques de contenido al final de una página de Notion existente. Entradas principales:
EntradaDescripción
ID de PáginaLa página a la cual agregar contenido
HijosUn arreglo JSON de objetos de bloque de Notion a agregar
Ejemplo — agregar un encabezado y un párrafo: 
[
  {
    "object": "block",
    "type": "heading_2",
    "heading_2": {
      "rich_text": [{ "type": "text", "text": { "content": "Ejecución de Flujo de Trabajo — 26 de Mayo" } }]
    }
  },
  {
    "object": "block",
    "type": "paragraph",
    "paragraph": {
      "rich_text": [{ "type": "text", "text": { "content": "3 registros procesados. 1 error encontrado." } }]
    }
  }
]
Ejemplo — agregar un elemento de lista con viñetas: 
[
  {
    "object": "block",
    "type": "bulleted_list_item",
    "bulleted_list_item": {
      "rich_text": [{ "type": "text", "text": { "content": "Nuevo lead: Jane Doe — jane@example.com" } }]
    }
  }
]
Ejemplo de caso de uso: Un flujo de trabajo se ejecuta cada mañana, procesa datos y agrega una entrada de registro de una línea a una página de “Registro Diario” — construyendo un rastro de auditoría continuo sin crear una nueva página cada vez.

​
Solución de Problemas

SíntomaCausa ProbableSolución
401 UnauthorizedToken revocado o faltanteRe-authorice a través del flujo OAuth
404 Not Found en página o base de datosContenido no compartido con la conexiónComparta la página a través de ··· → Conexiones
Resultados de búsqueda o consulta vacíosNada compartido con la conexiónComparta al menos una página o base de datos
Actualización de propiedad ignorada silenciosamenteNombre de propiedad con diferencia de mayúsculasUse Obtener Base de Datos para confirmar los nombres exactos de las propiedades — distinguen mayúsculas
Error oauth_not_configuredID secreto/cliente no guardado en Super AdminConsulte Configuración OAuth de Notion