Crear integraciones con la API de Notion

Crear integraciones con la API de Notion - imagen héroe
Contenido de este artículo

La API de Notion te permitirá crear integraciones internas personalizadas. Algunos de nuestros socios pueden requerir un token de integración interna para enlazar su plataforma a tu espacio de trabajo de Notion. Abajo te mostraremos cómo configurarlo 🏗️


Visita nuestro centro de desarrolladores para obtener documentación, recursos y herramientas de gestión de integraciones.

  • En tu barra lateral izquierda, ve a Configuración y miembros y luego a la pestaña Integraciones.

  • Solo los propietarios de los espacios de trabajo tendrán acceso a la pestaña Integraciones y podrán crear integraciones. Si no eres un administrador, contacta con el administrador de tu espacio de trabajo o utiliza otro espacio de trabajo.

  • Haz clic en el enlace Desarrollar tus propias integraciones, en la parte inferior.

  • De modo predeterminado, Mis integraciones se abrirá en tu navegador. Haz clic en el botón + Nueva integració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!

  • Proporciona un Nombre para tu integración. Otra opción que tienes es subir una imagen y usarla como Logotipo.

  • Utiliza el menú desplegable para especificar con qué Espacio de trabajo asociado deseas usar esta integración.

Nota: Las integraciones internas son específicas del espacio de trabajo; por eso, si quieres cambiar el espacio de trabajo asociado, tendrás que crear una nueva integración.

  • ¡Tu integración interna se ha añadido correctamente! Ahora podrás verla en tu espacio de trabajo, en el menú Configuración y miembrosMis integraciones.

  • Haz clic en ••• junto a la integración interna para recuperar el token de integración interna.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 a algunas plataformas asociadas.

En principio, todas las integraciones añadidas recientemente se consideran internas. Si eres un desarrollador que trabaja en una integración pública, usa primero las instrucciones anteriores para crear una integración interna.

Después, sigue las instrucciones de nuestra guía para desarrolladores para convertirla en una integración pública.

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 integraciones, se mostrará este nivel de acceso. Este nivel se mostrará también en el menú Compartir de cualquier página a la que se haya añadido la integración. Más información sobre la instalación de integraciones en un espacio de trabajo →


Danos tu opinión

¿Te ha resultado útil este recurso?