Módulo 5: Airtable y Notion

Conectar Airtable y Notion a n8n

Descripción de la cápsula

Este módulo trabaja con dos herramientas, así que esta cápsula conecta las dos de una vez. Ni Airtable ni Notion usan el flujo "Sign in with Google" de los módulos anteriores — cada una tiene su propio mecanismo, y ambos pasan por crear una integración (parecido a la app de Slack del Módulo 4).

La buena noticia: las dos son más simples que Slack. No hay scopes que marcar uno por uno ni reinstalaciones. Creas una integración, copias un token, y lo pegas en n8n. La parte que sí confunde a todos — y por eso le dedicamos atención — es que en ambas herramientas, crear la integración no le da acceso a tus datos automáticamente. Hay un segundo paso: darle acceso explícito a cada base (Airtable) o a cada página/base de datos (Notion). Esta cápsula te lleva por los dos pasos en cada herramienta.

El objetivo: terminar con dos credenciales funcionando y una lectura de prueba en cada herramienta.

Lo que vas a aprender

Al terminar esta cápsula serás capaz de:

✅ Crear una integración de Airtable y obtener su token
✅ Crear una integración de Notion y obtener su token
✅ Dar acceso explícito a tus bases y páginas (el paso que todos olvidan)
✅ Crear ambas credenciales en n8n
✅ Hacer una lectura de prueba en cada herramienta
✅ Entender el patrón común: token + acceso explícito

Conectar Airtable

Paso A1: crear el token de acceso

Entra a tu cuenta de Airtable → la página de developer hub / tokens de acceso personal (en la configuración de tu cuenta, sección de developers)
Crea un Personal Access Token
Al crearlo, Airtable te pide definir:
- Scopes: qué puede hacer el token. Para este módulo, los de leer y escribir datos de registros (algo como data.records:read y data.records:write), y leer la estructura (schema.bases:read)
- Access: a qué bases tiene acceso este token — y aquí está el paso clave

Paso A2: dar acceso a las bases

El paso que todos olvidan. Cuando creas el token, Airtable te pregunta a qué bases puede acceder. Si no agregas tu base de prueba aquí, el token existe pero no ve nada. Agrega explícitamente la(s) base(s) con la(s) que vas a trabajar.

Si más adelante creas una base nueva y tu workflow no la encuentra: vuelve al token y agrégala al acceso.

Paso A3: la credencial en n8n

n8n → Credentials → Add credential → busca Airtable
Selecciona Airtable Personal Access Token API (no la opción vieja de "API Key", que Airtable ya descontinuó)
Pega el token
Nómbrala: Airtable - cuenta negocio

Conectar Notion

Paso N1: crear la integración

Entra a notion.so/my-integrations
Click en New integration (o Create new integration)
Dale un nombre (Asistente n8n), elige el workspace, y el tipo Internal (interna — para tu propio uso)
Al crearla, Notion te da un token de integración (Internal Integration Secret) — cópialo

Paso N2: dar acceso a las páginas

El mismo paso que todos olvidan, otra vez. En Notion, crear la integración no le da acceso a tu workspace. Tienes que compartir explícitamente cada página o base de datos con la integración:

Abre la página o base de datos en Notion

Menú ••• (arriba a la derecha) → Conexiones / Connect to

Selecciona tu integración (Asistente n8n)

A partir de ahí, la integración ve esa página y todo lo que está dentro de ella. Si tu workflow "no encuentra" una base de datos de Notion, casi siempre es porque no se la compartiste a la integración.

Paso N3: la credencial en n8n

n8n → Credentials → Add credential → busca Notion
Selecciona Notion API (la opción de token interno)
Pega el token de integración
Nómbrala: Notion - workspace negocio

El patrón común: token + acceso explícito

Habrás notado que Airtable y Notion siguen la misma lógica, distinta de Google:

Paso	Airtable	Notion
1. Crear credencial	Personal Access Token	Integración interna
2. Dar acceso explícito	Agregar bases al token	Compartir páginas con la integración
3. Pegar token en n8n	Credencial Airtable PAT	Credencial Notion API

El concepto clave: en ambas, el token es una identidad sin permisos por defecto. El token no "es tú" — es un invitado que no entra a ninguna habitación hasta que le abres la puerta de cada una. Esto es bueno: tienes control fino. Pero es la causa #1 de "conecté todo y no funciona" — falta el paso 2.

Lecturas de prueba

Prueba Airtable

En Airtable, crea una base CRM prueba con una tabla Contactos y un par de registros. Asegúrate de que esta base esté en el acceso del token (paso A2).
En n8n: Manual Trigger → Airtable
- Resource: Record
- Operation: Search (o List)
- Base: CRM prueba
- Table: Contactos
Ejecuta. Si recibes tus registros como items: Airtable funciona.

Prueba Notion

En Notion, crea una base de datos Tareas prueba con un par de registros. Compártela con la integración (paso N2).
En n8n: Manual Trigger → Notion
- Resource: Database Page
- Operation: Get Many
- Database: Tareas prueba
Ejecuta. Si recibes tus páginas como items: Notion funciona.

Trampas comunes

Trampa 1: Token creado, acceso no dado

Qué pasa: La credencial parece bien pero el nodo no ve tus bases/páginas, o da error de permisos.

Cómo evitar: El paso 2 (dar acceso explícito) no es opcional. Airtable: agrega la base al token. Notion: comparte la página con la integración.

Trampa 2: Usar la API Key vieja de Airtable

Qué pasa: Buscas tu "API Key" de Airtable y no la encuentras, o no funciona.

Cómo evitar: Airtable descontinuó las API Keys. Ahora se usan Personal Access Tokens. Crea uno nuevo y usa la credencial Airtable Personal Access Token API en n8n.

Trampa 3: Compartir solo la página padre y esperar ver las hijas

Qué pasa: En Notion, compartes una página pero no la base de datos que está dentro de otra sección.

Cómo evitar: La integración ve una página y todo lo anidado dentro de ella. Si tu base de datos vive en otra rama del workspace, compártela (o comparte un ancestro común).

Trampa 4: Scopes insuficientes en el token de Airtable

Qué pasa: Puedes leer registros pero no escribir, o no ves la estructura de la tabla.

Cómo evitar: Al crear el token de Airtable, incluye los scopes de lectura y escritura de records, más el de leer el schema. Si te faltó uno, edita el token o crea otro.

Trampa 5: Exponer los tokens

Qué pasa: Pegas el token en un mensaje, repo o screenshot. Cualquiera con él accede a tus datos.

Cómo evitar: Trátalos como contraseñas. Ambas herramientas permiten revocar y regenerar el token si se filtra.

Ejercicio: conecta las dos

Objetivo: terminar con ambas credenciales funcionando y una lectura de prueba en cada herramienta.

Tu tarea

Airtable: crea un Personal Access Token con scopes de records (read/write) y schema; crea la base CRM prueba con tabla Contactos; agrega esa base al acceso del token; crea la credencial en n8n; haz la lectura de prueba
Notion: crea una integración interna; crea la base de datos Tareas prueba; compártela con la integración; crea la credencial en n8n; haz la lectura de prueba
Confirma que ambas lecturas devuelven tus registros

Checklist de éxito:

La credencial de Airtable lee la tabla Contactos
La credencial de Notion lee la base de datos Tareas prueba
Entiendes el patrón: token + acceso explícito (el paso 2 en ambas)

Resumen y siguiente paso

Airtable y Notion no usan "Sign in" — cada una se conecta con un token que pegas en n8n
En ambas, crear el token/integración no da acceso a los datos — hay un segundo paso obligatorio: dar acceso explícito (Airtable: agregar bases al token; Notion: compartir páginas con la integración)
El token es una identidad sin permisos por defecto — un invitado que no entra a ninguna habitación hasta que le abres la puerta
Airtable usa Personal Access Tokens (las API Keys viejas están descontinuadas); Notion usa una integración interna
En Notion, la integración ve una página y todo lo anidado dentro
5 trampas: token sin acceso dado, usar la API Key vieja, compartir solo la página padre, scopes insuficientes, exponer los tokens

Antes de avanzar deberías poder:

Conectar Airtable y Notion a n8n
Explicar el paso de "dar acceso explícito" en cada una
Hacer una lectura de prueba en ambas

Lo que sigue (cápsula 03):

Ya conectadas las dos, vamos a fondo con la primera: Airtable. Bases, tablas, records, y sobre todo los tipos de campo — lo que hace que Airtable sea estructura de verdad, no una hoja con otro nombre.

Recursos adicionales

Airtable: Personal Access Tokens - Cómo crear y configurar el token.
Notion: crear integraciones - El panel de integraciones de Notion.
n8n Airtable / Notion Credentials Docs - Setup de ambas credenciales en n8n.

Creado: Mayo 14, 2026 Versión: 1.0

← AnteriorIntroducción al Módulo: Airtable y Notion Siguiente →Airtable: Records y Tablas