> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integración con Airtable

> Conecta tu app de Base44 con Airtable para traer tus datos en vivo a dashboards, herramientas y flujos de trabajo.

<Info>
  <u>Nota</u>: La integración con Airtable está disponible en el plan Builder y superiores. Si estás en el plan gratuito, necesitarás actualizar tu app para usar funciones de backend y funciones de pago.
</Info>

# Configuración paso a paso:

## Parte 1: El lado de Airtable

Si ya tienes un token de API de Airtable y un Base ID, puedes pasar a la [**Parte 2: El lado de Base44**](https://docs.base44.com/Integrations/Airtable-integration#part-2%3A-the-base44-side).

<Steps>
  <Step title="Crea un Personal Access Token">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/AirtableBuilderHub.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=76937cf25bdd1fd4c0c868b440a75a8d" alt="Airtable Builder Hub Pn" width="1901" height="944" data-path="images/AirtableBuilderHub.png" />

    * Ve a la [<u>página de creación de tokens de Airtable</u>](https://airtable.com/create/tokens/new).
    * En "Scopes", crea un token con alcance para el workspace/base correcto con al menos:
      * `data.records:read`
      * `schema.bases:read` *(opcional pero útil para pruebas)*
    * Nombra tu token, establece un límite de crédito si los usas y copia el token en un lugar seguro.
  </Step>

  <Step title="Encuentra tu Base ID">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/HRTable.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=b08891d38f2972511b423d5bf467a005" alt="HR Table Pn" width="1891" height="944" data-path="images/HRTable.png" />

    1. Abre tu base de Airtable en un navegador.
    2. Mira la URL y copia la cadena que comienza con "**app**", ya que este es tu Base ID.

       Ejemplo: `https://airtable.com/app123XYZ/...`
  </Step>
</Steps>

***

## Parte 2: El lado de Base44

Una vez que tengas tu token de API y Base ID, puedes conectarlo a Base44 de dos formas distintas:

<CardGroup cols={2}>
  <Card icon="sparkle" href="https://docs.base44.com/Integrations/Airtable-integration#option-a%3A-ready-made-integration-create-a-new-app" title="Opción A: Integración lista (preferida)">
    * Elige esta opción si estás comenzando una nueva app desde cero.
  </Card>

  <Card icon="bolt" href="https://docs.base44.com/Integrations/Airtable-integration#option-b%3A-add-airtable-as-an-instant-integration" title="Opción B: Integración instantánea">
    * Elige esta opción si ya estás en medio de la construcción y deseas integrar Airtable en una app existente.
  </Card>
</CardGroup>

### Opción A: Integración lista (crear una nueva app)

<Steps>
  <Step title="Añade Airtable desde el catálogo de integraciones">
    <img src="https://mintcdn.com/base44/oUaRpzSyJvMVshj9/images/Integrations.png?fit=max&auto=format&n=oUaRpzSyJvMVshj9&q=85&s=16ac71b185167177ef260be7c92b0339" alt="Integrations Pn" width="1570" height="652" data-path="images/Integrations.png" />

    * En el catálogo de integraciones, selecciona Airtable.
    * Luego haz clic en "Use this integration".

          <img src="https://mintcdn.com/base44/-Vklow6W-uVvNnvR/images/image7.png?fit=max&auto=format&n=-Vklow6W-uVvNnvR&q=85&s=041a8013c65236fe5f17e3d7303461ab" alt="Image7 Pn" width="1877" height="878" data-path="images/image7.png" />
  </Step>

  <Step title="Pega tus secretos">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/B44AirtableIntegration.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=591c4433e5721fab7cbb0b82c6d847a9" alt="B44airtable Integration Pn" width="1877" height="867" data-path="images/B44AirtableIntegration.png" />

    * Cuando se te solicite, pega:
      * `AIRTABLE_API_KEY`
      * `AIRTABLE_BASE_ID`
  </Step>

  <Step title="Construye tu app">
    * Aquí tienes un prompt de ejemplo que puedes usar:

      `"Construye un dashboard interno. Nos conectaremos a mi base de Airtable y mostraremos registros reales. Incluye una página de Estado de Sincronización y comienza permitiéndome elegir una tabla antes de construir visualizaciones."`
    * La app ejecuta una llamada de prueba a Airtable y lista tus tablas.
    * Tú seleccionas una.
    * Obtiene registros reales y muestra una tabla de datos en bruto para que el esquema sea claro.
  </Step>

  <Step title="Página de estado de sincronización">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/HRDashboardSync.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=b381c4548b5efb2c3135ad1df01d02e3" alt="HR Dashboard Sync Pn" width="1873" height="869" data-path="images/HRDashboardSync.png" />

    Obtendrás una página con lo siguiente:

    * Un botón **Check Connection** para volver a ejecutar la prueba.
    * Lista de tablas.
    * Hora de la última verificación.
    * Estado de la conexión.
  </Step>
</Steps>

***

### **Opción B: Añadir Airtable como integración instantánea**

Elige esta opción si ya tienes una app en progreso.

<Steps>
  <Step title="Accede a tu app existente">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/HRDashboard.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=8409b5ee99da7d9ff4dc41c36adbfff4" alt="HR Dashboard Pn" width="1876" height="871" data-path="images/HRDashboard.png" />

    * Aquí está el prompt que escribimos en el chat de IA para construir nuestra app de ejemplo:

      `"Construye un dashboard interno. Déjame elegir una fuente de datos más tarde."`
  </Step>

  <Step stepNumber={2} title="Conecta con Airtable a través del chat de IA">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/ConnectAirtableApp.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=124a38233bf1d5dba4f7df5365c14142" alt="Connect Airtable App Pn" width="1874" height="868" data-path="images/ConnectAirtableApp.png" />

    * Aquí hay un prompt de ejemplo que pegamos en nuestro chat de IA:

      `Conecta esta app a Airtable. Pídeme AIRTABLE_API_KEY y AIRTABLE_BASE_ID y guárdalos como Secrets. Añade una función backend que pueda probar la conexión y obtener registros. Crea una página de Estado de Sincronización con un botón Check Connection.`
    * Haz clic en "**Set secrets**" en el chat de IA.
    * Pega tu **API Key** y **Base ID** cuando se te solicite.
  </Step>

  <Step stepNumber={3} title="Obtén tablas y muestra datos">
    * Pídele al chat de IA que te muestre los datos.
    * Aquí hay un prompt de ejemplo que usamos para nuestra app:

      `Ejecuta la prueba de conexión para listar mis tablas, déjame elegir una, luego obtén los registros y muestra una vista de tabla en bruto antes de cualquier visualización.`
  </Step>

  <Step stepNumber={4} title="Prueba tu app">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/HRDashboardSync.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=b381c4548b5efb2c3135ad1df01d02e3" alt="HR Dashboard Sync Pn" width="1873" height="869" data-path="images/HRDashboardSync.png" />

    * Abre **Sync Status** y haz clic en **Check Connection**.
    * Elige una tabla y confirma que ves filas en vivo.
  </Step>
</Steps>

***

## **Solución de problemas**

* **403 o falla de conexión** – El alcance del token es incorrecto. Asegúrate de que data.records:read esté habilitado. Añade schema.bases:read si falla el listado de tablas.
* **Base ID incorrecto** – Verifica que copiaste la cadena app... de la URL.
* **No se muestran datos** – Asegúrate de que la base realmente tenga registros y que el token tenga acceso.
* **Vista previa pública vs. sesión del builder** – Mantente con sesión iniciada en el builder mientras pruebas el Estado de Sincronización.

***

## **Casos de uso comunes**

Aquí tienes algunas formas en que los equipos suelen usar Airtable con Base44:

* **Dashboards** – Trae datos de Airtable y visualízalos en tiempo real.
* **Gestión de datos** – Dale a tus compañeros una UI amigable para ver o verificar registros de Airtable.
* **Monitores de sincronización** – Crea una página de Estado de Sincronización para probar rápidamente conexiones y confirmar actualizaciones.
* **Herramientas internas** – Construye apps ligeras (como vistas de CRM o seguimiento de contenido) sobre Airtable sin código personalizado.

<Note>Esta página se tradujo con IA. Para información más precisa y actualizada, consulta la [versión en inglés](/). </Note>
