Aprovisionar usuarios y grupos con SCIM

La API de SCIM de Notion te permite hacer lo siguiente:

• Crea y elimina miembros del espacio de trabajo.

• Actualiza la información del perfil de los miembros.

• Recupera miembros del espacio de trabajo.

• Encuentra miembros por correo electrónico o por nombre.

• Crea y elimina grupos del espacio de trabajo.

• Añade y elimina miembros de cualquier grupo.

• Recupera grupos del espacio de trabajo.

• Encuentra grupos por nombre.

En este momento Notion es compatible con Okta, OneLogin, Rippling y aplicaciones de SCIM personalizadas. Si tienes otro proveedor de identidades, ponte en contacto con nosotros. Consulta las instrucciones para la configuración del proveedor de identidad para aplicaciones específicas aquí →

Para usar el SCIM con Notion:

• Tu espacio de trabajo debe pertenecer a un plan Enterprise.

• El proveedor de identidades (IdP) debe ser compatible con el protocolo SAML 2.0. Consulta las instrucciones para la configuración del proveedor de identidad para aplicaciones específicas aquí →

• Un propietario del espacio de trabajo de Notion debe configurar el SCIM.

• Si quieres emplear SCIM para modificar el nombre o la dirección de correo electrónico de un usuario, debes verificar primero la propiedad de su dominio de correo electrónico. Descubre más sobre la verificación de dominios →

Solo los propietarios de organizaciones con el plan Enterprise pueden generar y ver los tokens de la API de SCIM. Para crear un token de API de SCIM:

1. Abre el selector de espacios de trabajo y selecciona Gestionar organización Si aún no lo has hecho, es posible que primero tengas que configurar tu organización. Descubre más aquí →

2. En la pestaña General de los controles a nivel de la organización, selecciona > junto a Aprovisionamiento de SCIM.

Cuando un propietario de un espacio de trabajo deje el espacio o cambie de rol, se revocará su token. En estos casos, se enviará un mensaje automático al resto de los propietarios del espacio de trabajo para avisarles de que deben sustituir el token revocado.

Además, cualquiera de los propietarios del espacio de trabajo puede revocar los tokens activos. Para revocar un token, haz clic en 🗑  junto al token correspondiente.

Si se revoca un token, deberás reemplazarlo en cualquier integración existente.

Cualquier integración de SCIM y aprovisionamiento de usuarios que dependa del token revocado se desactivará hasta que sea reemplazado por un token activo.

Para controlar si los usuarios recibirán invitaciones a espacios de trabajo y grupos por correo electrónico cuando cuenten con el aprovisionamiento de SCIM, los propietarios de la organización con el plan Enterprise pueden:

1. Abre el selector de espacios de trabajo y selecciona Gestionar organización

2. En la pestaña General, activa la opción Suprimir correos electrónicos de invitación del aprovisionamiento de SCIM si no quieres enviar correos electrónicos a los usuarios.

• GET /ServiceProviderConfig

  • GET <https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=scim mem-invalid-attributes-holder=v2 mem-invalid-attributes-holder=serviceproviderconfig>


  • Recupera una descripción de las funciones de la especificación SCIM disponibles.

  • Según definición de la  Sección 5 de la especificación del protocolo SCIM.

• GET /ResourceTypes

  • GET <https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=scim mem-invalid-attributes-holder=v2 mem-invalid-attributes-holder=resourcetypes>


  • Recupera una lista de los tipos de recursos de SCIM disponibles.

  • Según definición de la Sección 6 de la especificación del protocolo SCIM.

La siguiente tabla muestra el mapeo entre los atributos de usuario de SCIM y los campos del perfil de usuario de Notion. Si los usuarios eligen compartir valores de atributos adicionales con Notion, esos atributos se almacenarán para mejorar la experiencia del producto de Notion.

• GET /Users

  • GET <https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=scim mem-invalid-attributes-holder=v2 mem-invalid-attributes-holder=users>


  • Recupera una lista paginada de miembros del espacio de trabajo.

  • Puedes numerar las páginas mediante los parámetros startIndex y count. Ten en cuenta que el parámetro startIndex está indexado a 1 y el parámetro count tiene un máximo de 100.

  • 
    Puedes filtrar los resultados con el parámetro filter. Los atributos válidos que pueden utilizarse como filtros son los siguientes: email, given_name y family_name, por ejemplo, GET <https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=scim mem-invalid-attributes-holder=v2 users?startindex="1&count=50&filter=email">
eq [email protected]

  • Ten en cuenta que given_name y family_name distinguen entre mayúsculas y minúsculas. La dirección de correo electrónico se convierte a minúsculas.

• GET /Users/<id>

  • GET <https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=scim mem-invalid-attributes-holder=v2 mem-invalid-attributes-holder=users/><id>

  • Recupera un miembro específico del espacio de trabajo por su ID de usuario de Notion. Se trata de un UUID con 32 caracteres y el siguiente formato: 00000000-0000-0000-0000-000000000000.

  • Ten en cuenta que ni meta.created ni meta.lastModified reflejan valores de marca temporal significativos.

• POST /Users

  • POST <https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=scim mem-invalid-attributes-holder=v2 mem-invalid-attributes-holder=users>


  • Si el usuario que quieres añadir ya tiene una cuenta de usuario de Notion con la misma dirección de correo electrónico, se añadirá el usuario al espacio de trabajo.

  • Si el usuario no existe, esta llamada creará un nuevo usuario de Notion y lo añadirá al espacio de trabajo. Se lo asignará al perfil de usuario de Notion que se creó.

  • La API de SCIM leerá la propiedad de la foto de perfil al crear el usuario, pero no en futuras actualizaciones.

• PATCH /Users/<id>

  • PATCH <https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=scim mem-invalid-attributes-holder=v2 mem-invalid-attributes-holder=users/><id>

  • Actualiza mediante una serie de operaciones y devuelve el registro de usuario actualizado.

• PUT /Users/<id>

  • PUT <https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=scim mem-invalid-attributes-holder=v2 mem-invalid-attributes-holder=users/><id>

  • Actualiza y devuelve el registro de usuario actualizado.

• DELETE /Users/<id>

  • DELETE <https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=scim mem-invalid-attributes-holder=v2 mem-invalid-attributes-holder=users/><id>

  • Elimina un usuario del espacio de trabajo. Se cierran todas las sesiones abiertas del usuario.

    • La cuenta de usuario no puede eliminarse mediante SCIM. Debe eliminarse manualmente.

    • Para eliminar un usuario de tu espacio de trabajo, también puedes cambiar el atributo del usuario active (activo) a false (falso) enviando una solicitud PATCH /Users/<id> o PUT /Users/<id>.

    • Nota: El propietario del espacio de trabajo que generó el token del bot SCIM no se puede eliminar a través de la API. Cuando se elimine al propietario de un espacio de trabajo mediante la API de SCIM, se revocarán los tokens que este haya creado y se cancelarán todas las integraciones que usen ese bot.

• GET /Groups

  • GET <https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=scim mem-invalid-attributes-holder=v2 mem-invalid-attributes-holder=groups>


  • Recupera una lista paginada de grupos del espacio de trabajo.

  • 
    Puedes numerar las páginas mediante los parámetros startIndex y count. Ten en cuenta que el parámetro startIndex está indexado a 1 y el parámetro count tiene un máximo de 100, p. ej. GET <https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=scim mem-invalid-attributes-holder=v2 groups?startindex="1&count=5">


    • Si no se utiliza paginación, se devolverá un máximo de 100 grupos de espacio de trabajo para cada solicitud.

  • 
    Puedes filtrar los resultados con el parámetro filter. Los grupos se pueden filtrar por el atributo displayName (nombre público), por ejemplo, GET <https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=scim mem-invalid-attributes-holder=v2 groups?filter="displayName">
eq Designers

• GET /Groups/<id>

  • GET <https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=scim mem-invalid-attributes-holder=v2 mem-invalid-attributes-holder=groups/><id>

  • Recupera a un grupo específico del grupo del espacio de trabajo por su ID de grupo de Notion. Se trata de un UUID con 32 caracteres y el siguiente formato: 00000000-0000-0000-0000-000000000000.

• POST /Groups

  • POST <https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=scim mem-invalid-attributes-holder=v2 mem-invalid-attributes-holder=groups>


  • Crea un nuevo grupo del espacio de trabajo.

• PATCH /Groups/<id>

  • PATCH <https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=scim mem-invalid-attributes-holder=v2 mem-invalid-attributes-holder=groups/><id>

  • Actualiza un grupo del espacio de trabajo mediante una serie de operaciones.

• PUT /Groups/<id>

  • PUT <https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=scim mem-invalid-attributes-holder=v2 mem-invalid-attributes-holder=groups/><id>

  • Actualiza un grupo del espacio de trabajo.

• DELETE /Groups/<id>

  • DELETE <https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=scim mem-invalid-attributes-holder=v2 mem-invalid-attributes-holder=groups/><id>

  • Elimina un grupo del espacio de trabajo.