Conexiones para la API de Notion
Con la API de Notion, podrás crear conexiones internas personalizadas. Algunos de nuestros socios también pueden requerir un token de API para enlazar su plataforma con tu espacio de trabajo de Notion; a continuación, te explicamos cómo configurarlo.
Puedes gestionar los tokens de acceso personal desde Notion. Activa el Modo desarrollador desde Ajustes y, a continuación, abre los tokens de acceso personal desde la sección de desarrollador en tu barra lateral. Visita nuestro Centro para obtener documentación, recursos y herramientas de gestión de conexiones.
Nota: Cada conexión tiene uno o más propietarios, y cada propietario puede gestionar la conexión y obtener su token de API. Quién puede crear una conexión depende de tu plan y de la configuración de tu espacio de trabajo. Más información sobre la configuración de conexiones Enterprise →
¿Buscas tokens de administrador? Los tokens de Esta página funcionan dentro de un espacio de trabajo y gestionan el contenido de la página. Si necesitas ejecutar tareas de administrador de la organización, como exportar, suspensiones legales o cerrar la sesión de los usuarios, consulta Admin APIs para organizaciones Enterprise.
¿Qué token necesito? Notion utiliza varios tipos de tokens. El que copias para una conexión interna es el token de API, del que trata este artículo. Los tokens de acceso personal están vinculados a tu cuenta. OAuth gestiona el acceso a las apps en las que inicias sesión. Si una plataforma asociada te pide un token para una conexión que has creado, utiliza el token de API.
En la barra lateral izquierda, dirígete a
Configuracióny después a la pestañaConexiones.Quién puede crear una conexión depende de tu espacio de trabajo. En los planes Gratuito y Plus, solo los propietarios del espacio de trabajo pueden crear conexiones. En los planes Business y Enterprise, los propietarios del espacio de trabajo también pueden permitir que los miembros, o los miembros de ciertos grupos, las creen. Si no puedes crear una conexión, pide ayuda a un propietario del espacio de trabajo.
Activa el Modo desarrollador y, a continuación, abre los tokens de acceso personal desde la sección de desarrollador en tu barra lateral.
Haz clic en
+ Nuevo ítem de conexión.Proporciona un
Nombrepara tu conexión. Opcionalmente, también puedes subir una imagen para usarla comologotipo.Utiliza el menú desplegable para especificar con qué
Espacio de trabajo asociadoquieres usar esta conexión.
Nota: Asegúrate de haber iniciado sesión en Notion en la web con la misma cuenta que has usado en la aplicación de escritorio. ¡De lo contrario, no verás la cuenta ni los espacios de trabajo correctos!

¡Tu conexión interna se ha añadido correctamente! Ahora podrás verla en tu espacio de trabajo, en el menú
Configuración→Conexiones.Haz clic en
•••junto a la conexión interna para copiar su token de API. Necesitarás este token para cualquier automatización o flujo de trabajo basado en la API que cree tu equipo, o bien para enlazar tu espacio de trabajo con algunas plataformas asociadas.

Nota: Las conexiones internas son específicas de cada espacio de trabajo. Por tanto, para cambiar el espacio de trabajo asociado, deberás crear una nueva conexión.

Cada conexión interna tiene al menos un propietario. Los propietarios pueden cambiar la configuración de la conexión y obtener su token de API. Puedes compartir la propiedad para que más de una persona pueda gestionar la misma conexión. De este modo, el trabajo no se detiene si alguien cambia de puesto o se marcha.
Para añadir o eliminar a un propietario:
Abre el Portal de desarrolladores y selecciona tu conexión.
Abre la pestaña
Propietarios de la conexión.Añade a un miembro o un grupo como propietario, o quítalo de la lista de propietarios.
Ten en cuenta lo siguiente sobre los propietarios de la conexión:
Solo los miembros de pleno derecho y los propietarios del espacio de trabajo pueden ser propietarios. Los invitados y los miembros con acceso limitado no pueden serlo.
A quién puedes añadir como propietario también depende de la configuración de tu espacio de trabajo sobre quién puede crear conexiones.
Una conexión siempre mantiene al menos un propietario, por lo que no puedes eliminar al último.
Si eres propietario de un espacio de trabajo y necesitas hacerte cargo de una conexión, añádete primero como propietario.
Si el último propietario abandona el espacio de trabajo, el token de API de la conexión deja de funcionar inmediatamente.
Puedes compartir la propiedad en los planes Plus, Business y Enterprise usando Notion en el navegador o en la app de escritorio.
En principio, todas las conexiones añadidas recientemente se consideran internas. Si eres un desarrollador que trabaja en una conexión pública, usa primero las instrucciones anteriores para crear una conexión interna.
Después, completa los pasos que se indican en nuestra guía para desarrolladores para convertirla en una conexión pública.
Cuando creas una conexión pública, eliges quién puede instalarla:
Cualquier espacio de trabajo: cualquiera puede instalar tu conexión en su propio espacio de trabajo de Notion.Espacios de trabajo seleccionados: solo los espacios de trabajo que indiques pueden instalar tu conexión.
Elige Espacios de trabajo seleccionados cuando estés creando algo solo para tu propia empresa y no quieras que otras organizaciones lo instalen.
Notion comprueba esto cada vez que alguien instala tu conexión. Si su espacio de trabajo no está en tu lista, la instalación se detiene y le aparece un mensaje de error.
Solo las conexiones que cualquiera puede instalar pueden aparecer en la galería de conexiones. Una conexión limitada a espacios de trabajo seleccionados no aparecerá allí.
Nota: Eliges esto cuando creas la conexión. Si necesitas una configuración distinta más adelante, crea una conexión nueva.
Una conexión de tu propiedad aparece en el portal para desarrolladores para cada espacio de trabajo que tiene permiso para instalarla, que ya la tiene instalada o que es el espacio de trabajo donde la creaste.
Cada conexión pública tiene un espacio de trabajo donde la creas y la pruebas. Puedes cambiar a otro distinto sin tener que empezar de cero.
Abre tu conexión en el portal para desarrolladores.
Ve a los ajustes de la conexión.
Elige el espacio de trabajo en el que quieres crear y probar la conexión.
Notion conecta la conexión al espacio de trabajo que has elegido. No necesitas crear otra.
Durante el proceso de configuración de la aplicación, los desarrolladores podrán elegir el nivel de acceso requerido del usuario.
Capacidades de contenido:
Solo leer contenido
Solo escribir contenido
Insertar contenido
Capacidades de usuario:
Sin información de usuario
Leer información de usuario (sin incluir la dirección de correo electrónico del usuario)
Leer información de usuario (incluido el correo electrónico)
Cuando los usuarios instalen conexiones, se mostrará este nivel de acceso. También aparecerá en el menú Compartir de cualquier página a la que se haya añadido la conexión. Más información sobre la instalación de conexiones en un espacio de trabajo →
Los webhooks de conexión permiten a las conexiones supervisar y responder a los cambios en los espacios de trabajo de Notion en tiempo real.
Cuando hay modificaciones en las páginas o bases de datos compartidas con la conexión, Notion envía automáticamente notificaciones al punto final del webhook, lo que permite que tu conexión actualice otras herramientas, ejecute tareas automatizadas o muestre los últimos cambios al instante.
Accede a nuestra documentación para desarrolladores para consultar las instrucciones.
Actualmente, los webhooks de conexión no admiten notificaciones sobre lo siguiente:
Cambios de usuario (incluidos cambios en los miembros del espacio de trabajo, actualizaciones de correo electrónico/nombre y modificaciones de permisos).
Cambios en la configuración del espacio de trabajo y del espacio de equipo.
Para este tipo de notificaciones, utiliza el registro de auditoría.
Las acciones de webhook y los Webhooks de conexiones comparten algunas similitudes: ambos tienen disparadores y pueden enviar eventos a servicios de terceros. Sin embargo, los Webhooks de conexiones ofrecen capacidades más amplias:
Pueden monitorear la actividad en múltiples espacios de trabajo.
Pueden manejar un número ilimitado de acciones.
Por el contrario, las acciones de webhook están diseñadas para casos de uso más simples y se configuran a través de automatizaciones de bases de datos con un conjunto limitado de disparadores.
