> ## 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.

# Conectar Notion a tu app

> Lee y escribe páginas y bases de datos de Notion, añade comentarios y ejecuta flujos de trabajo desde tu app, con una cuenta de Notion compartida o con la cuenta propia de cada persona.

Conecta tu app a Notion para leer y escribir páginas y bases de datos, añadir comentarios y ejecutar flujos de trabajo cuando algo cambia en tu espacio de trabajo de Notion. Usa una cuenta compartida para toda tu app o deja que cada persona conecte su propia cuenta de Notion.

***

## Qué puedes hacer

Lleva tus páginas y bases de datos de Notion a los flujos de trabajo de tu app.

> [card] Sincronizar bases de datos
>
> Muestra filas de una base de datos de Notion en tu app, o mantén una base de datos al día con los registros de tu app.

> [card] Escribir páginas
>
> Crea páginas de Notion desde tu app, como una página por cada cliente nuevo, o añade novedades a una página existente.

> [card] Trabajar con comentarios
>
> Lee los comentarios de una página y añade comentarios nuevos desde tu app.

> [card] [Ejecutar flujos de trabajo](https://docs.base44.com/es/Building-your-app/Creating-workflows.md#connector)
>
> Inicia un flujo de trabajo cuando se crea, actualiza, mueve o elimina una página o base de datos, o cuando alguien comenta.

**Prompts de ejemplo**

Describe en el chat de IA la página o base de datos, qué inicia la acción y cualquier campo dinámico. Por ejemplo:

```text wrap theme={null}
Sincroniza una base de datos de Notion con los registros de mi CRM.
```

```text wrap theme={null}
Escribe las novedades de los proyectos de esta app en una página de Notion.
```

```text wrap theme={null}
Muestra en mi panel el progreso de la lista de Notion para la incorporación del equipo.
```

```text wrap theme={null}
Crea páginas nuevas de Notion para cada cliente nuevo que se añada en mi app.
```

***

## Conectar Notion

Elige cómo se conectan las personas: una cuenta compartida para toda tu app o la cuenta propia de cada persona.

> [tab] Conector compartido
>
> Conecta una cuenta de Notion. Todas las apps que usan la conexión, y todas las personas que usan esas apps, la comparten junto con las páginas que puede ver.
>
> **Para añadir un conector compartido de Notion:**
>
> 1. Haz clic en **Conectores** en la barra lateral de tu espacio de trabajo.
>
> 2. Haz clic en **Agregar conector**.
>
> 3. Busca **Notion** y haz clic en él.
>
> 4. Selecciona **Conector compartido** y luego haz clic en **Siguiente**.
>
> 5. Introduce un **Nombre de la conexión**.
>
> 6. Elige dónde se puede usar la conexión en **Quién tiene acceso**:
>    * **Apps y Super agente:** Tus apps y tu Superagent pueden usarla. Es la opción predeterminada.
>    * **Solo apps:** Solo tus apps pueden usarla.
>    * **Solo Super agente:** Solo tu Superagent puede usarla.
>
> 7. Elige lo que puede hacer tu app en **Permisos**. **read content** y **read comment** ya están seleccionados. Añade los que necesite tu app:
>
>    * **insert content:** Crea páginas y añade filas a bases de datos.
>    * **update content:** Cambia páginas y filas de bases de datos existentes.
>    * **insert comment:** Añade comentarios.
>
>    ![Configuración del conector compartido de Notion con Connection name, Who can access y Permissions con read content y read comment seleccionados](https://mintcdn.com/base44/astRE1z0rD_F1xsn/images/apps-connectors-notion-shared-setup.png?fit=max\&auto=format\&n=astRE1z0rD_F1xsn\&q=85\&s=4613834e2b9b1e12620ed0d4c2e5a189)
>
>    Configurar un conector compartido de Notion
>
> 8. Haz clic en **Agregar conector**.
>
> 9. Inicia sesión en Notion y elige las páginas que puede usar tu app. Más información en la guía de Notion para [instalar una conexión](https://www.notion.com/help/add-and-manage-connections-with-the-api#install-directly-from-a-partner-platform-via-oauth).

> [tab] Conector para usuarios de la app
>
> Cada persona conecta su propia cuenta de Notion, así tu app puede trabajar con las páginas que decide compartir.
>
> > [!WARNING]
> >
> > Solo los propietarios y administradores del espacio de trabajo pueden configurarlo.
>
> > [!TIP]
> >
> > **Antes de configurarlo:** Necesitas una integración pública de Notion y su ID de cliente y secreto del cliente. Consulta [Usar tu propio cliente OAuth](https://docs.base44.com/es/Integrations/Connectors.md#using-your-own-oauth-client).
>
> **Para añadir un conector de Notion para usuarios de la app:**
>
> 1. Haz clic en **Conectores** en la barra lateral de tu espacio de trabajo.
>
> 2. Haz clic en **Agregar conector**.
>
> 3. Busca **Notion** y haz clic en él.
>
> 4. Selecciona **Conector de usuario de la app** y luego haz clic en **Siguiente**.
>
> 5. Copia la **URL de callback**.
>
> 6. Añade la URL de callback como URI de redirección en la configuración de tu integración de Notion.
>
> 7. Completa el formulario **Add Notion Connection**:
>
>    * **Nombre del conector:** Un nombre que reconozcas más tarde.
>    * **ID de cliente** y **Secreto del cliente:** Cópialos de la configuración de tu integración de Notion.
>
>    ![Formulario Add Notion Connection con Callback URL, Connector name, Client ID y Client Secret](https://mintcdn.com/base44/astRE1z0rD_F1xsn/images/apps-connectors-notion-app-user-credentials.png?fit=max\&auto=format\&n=astRE1z0rD_F1xsn\&q=85\&s=2d7f3ef817379a121bb34c45ca966c6a)
>
>    Introducir las credenciales de tu integración de Notion
>
> 8. Haz clic en **Agregar conector**.
>
> 9. Abre tu app en el editor de la app.
>
> 10. Pide al chat de IA que añada una forma de que las personas conecten su propia cuenta de Notion.

***

## Alcances y permisos

Controlas el acceso de tu app a Notion en 2 lugares. En Base44, eliges lo que puede hacer tu app. En Notion, quien inicia sesión elige qué páginas puede ver.

> [card]
>
> **1. Eliges en Base44**
>
> Para un conector compartido, elige lo que puede hacer tu app en **Permisos**. Tu app puede leer páginas, bases de datos y comentarios de forma predeterminada. Añade los permisos de escritura cuando también necesite crear o cambiar páginas, filas o comentarios.
>
> Para un conector para usuarios de la app, lo que puede hacer tu app depende de las capacidades configuradas en tu integración de Notion.
>
> **2. Eliges en Notion**
>
> Quien inicia sesión en Notion elige las páginas que puede usar tu app. Eres tú en un conector compartido, y cada persona en un conector para usuarios de la app. Más información en la guía de Notion para [instalar una conexión](https://www.notion.com/help/add-and-manage-connections-with-the-api#install-directly-from-a-partner-platform-via-oauth).
>
> **Acceso:** Tu app trabaja con las páginas y bases de datos compartidas al iniciar sesión, en el espacio de trabajo de Notion en el que inició sesión la persona. Cada conexión muestra el nombre de su espacio de trabajo de Notion, así puedes distinguir las conexiones.

***

## Usar funciones de backend

Una vez conectado Notion, tus funciones de backend pueden obtener un token de acceso y llamar directamente a la API de Notion. Base44 gestiona el inicio de sesión por ti.

* Para una conexión compartida, usa `getConnection()` para obtener el token.
* Para una conexión de usuario de la app, usa `getCurrentAppUserConnection()` para que cada solicitud use el token de la persona que inició sesión.

Llama a la API de Notion en `api.notion.com`. Pasa el token en el encabezado `Authorization` y la versión de la API en el encabezado `Notion-Version`:

```javascript theme={null}
// Shared connection: one account the whole app uses
const { accessToken } = await base44.asServiceRole.connectors.getConnection("notion");

const response = await fetch("https://api.notion.com/v1/search", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${accessToken}`,
    "Notion-Version": "2025-09-03",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ query: "Clients" }),
});
const { results } = await response.json();
```

> [card] [Conectores compartidos](https://docs.base44.com/es/developers/backend/resources/connectors/shared-connectors.md)
>
> Configura, despliega y llama a una conexión compartida desde una función de backend.

> [card] [Conectores para usuarios de la app](https://docs.base44.com/es/developers/backend/resources/connectors/app-user-connectors.md)
>
> Obtén un token por usuario y llama a la API como la persona que inició sesión.

***

## Solución de problemas

Revisa la conexión y las páginas que puede ver si Notion deja de funcionar en tu app.

> [accordion] Hay que volver a conectar la conexión
>
> Si tu app pierde el acceso a Notion o su inicio de sesión caduca, la conexión muestra una sección **Volver a conectar esta conexión**.
>
> * **Conector compartido:** [Vuelve a conectarlo](https://docs.base44.com/es/Integrations/Connectors.md#managing-your-connectors) e inicia sesión con la misma cuenta de Notion. Todas las apps que lo usan vuelven a funcionar.
> * **Conector para usuarios de la app:** Cada persona vuelve a conectar su propia cuenta de Notion desde tu app.

> [accordion] Tu app no encuentra una página o una base de datos
>
> Tu app solo ve las páginas compartidas con la conexión. Vuelve a conectarla y elige la página en Notion, o [añade la conexión a la página](https://www.notion.com/help/add-and-manage-connections-with-the-api#add-connections-to-pages) en Notion.

> [accordion] Un flujo de trabajo se ejecuta demasiado a menudo
>
> Notion envía un evento cada vez que cambia el contenido de una página, así que un espacio de trabajo con mucha actividad puede iniciar un flujo de trabajo muchas veces. Pide al chat de IA que añada una condición para que el flujo de trabajo solo se ejecute para una página o base de datos.

> [!NOTE]
>
> Esta página fue traducida con IA. Para obtener la información más precisa y actualizada, consulta la [versión en inglés](https://docs.base44.com/index.md).


## Related topics

- [Conectar Slack a tu app](https://docs.base44.com/es/Integrations/slack-connectors.md)
- [Conectar Wix a tu app](https://docs.base44.com/es/Integrations/wix-connector.md)
- [Conectar Outlook a tu app](https://docs.base44.com/es/Integrations/outlook-connector.md)
- [Conectar Databricks a tu app](https://docs.base44.com/es/Integrations/databricks-connector.md)
- [Conectar Snowflake a tu app](https://docs.base44.com/es/Integrations/snowflake-connector.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.