Usuários e grupos de provisões com SCIM

A API SCIM do Notion permite que você faça o seguinte:

• Crie e remova membros no seu espaço de trabalho.

• Atualize as informações do perfil de um membro.

• Recupere os membros do espaço de trabalho.

• Encontre membros por e-mail ou nome.

• Crie e remova grupos no seu espaço de trabalho.

• Adicione e remova membros de um grupo.

• Recupere os grupos no seu espaço de trabalho.

• Encontre grupos pelo nome.

Atualmente somos compatíveis com OneLogin, Okta, Rippling e aplicações SCIM personalizadas. Se você usar outro provedor de identidade, nos avise. Veja como configurar o Provedor de Identidade para aplicativos específicos aqui →

Para usar SCIM no Notion:

• O espaço de trabalho precisa estar cadastrado em um Plano Enterprise.

• O provedor de identidade (IdP) deve ser compatível com o protocolo SAML 2.0. Veja como configurar o Provedor de Identidade para aplicativos específicos aqui →

• O proprietário do espaço de trabalho deve configurar a autenticação SAML no espaço de trabalho do Notion.

• É preciso ter verificado a propriedade de um domínio de e-mail se quiser usar o SCIM para modificar o nome ou endereço de e-mail de usuário. Saiba mais sobre a verificação de domínio →

Apenas os proprietários da organização em Planos Enterprise podem gerar e visualizar tokens de API SCIM. Para criar um token de API SCIM:

1. Abra o seletor de espaço de trabalho e selecione Gerenciar a organização. Pode ser necessário Configurar organização primeiro, caso ainda não tenha feito isso. Saiba mais aqui →

2. Na guia Geral dos controles no nível da sua organização, selecione > ao lado de Provisionamento SCIM.

Quando um proprietário deixa um espaço de trabalho ou tem sua função alterada, o token dele é revogado. Quando isso acontece, os outros proprietários do espaço de trabalho recebem uma mensagem automática para substituir o token revogado.

Além disso, tokens ativos podem ser revogados por qualquer um dos proprietários do espaço de trabalho. Para revogar um token, clique no 🗑 ao lado do token pertinente.

Se um token for revogado, será preciso substituí-lo em todas as integrações existentes.

Todas as integrações de SCIM e provisionamentos de usuários que dependam do token revogado ficarão desativadas até que haja a substituição por um token ativo.

Para controlar se os usuários receberão convites para espaços de trabalho e grupos por e-mail quando provisionados pelo SCIM, os proprietários de organizações no Plano Enterprise podem:

1. Abra o seletor de espaço de trabalho e selecione Gerenciar a organização.

2. Na guia Geral, habilite Suprimir convites por e-mail do provisionamento de SCIM se não quiser enviar e-mails aos usuários.

• 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>


  • Recupere uma descrição das características de especificação SCIM disponíveis.

  • Definido em Seção 5 da Especificação do Protocolo de 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>


  • Recupere uma lista dos tipos de recursos SCIM disponíveis.

  • Definido em Seção 5 da Especificação do Protocolo de SCIM.

A tabela abaixo define o mapeamento entre os campos "Atributos de usuário SCIM" e "Perfil de usuário do Notion". Se os usuários optarem por compartilhar valores de atributos adicionais com o Notion, esses atributos serão armazenados para melhorar a experiência do produto 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>


  • Recupere uma lista paginada de membros do espaço de trabalho.

  • Você pode paginar usando os parâmetros startIndex e count. Observe que startIndex está indexado a 1, e o máximo de count é 100.

  • 
    Você pode filtrar os resultados com o parâmetro filtro.  Os atributos válidos para filtragem são email, given_name, e family_name, por exemplo, 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]

  • Observe que given_name e family_name diferenciam maiúsculas e minúsculas. O e-mail é convertido para 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>

  • Recupere um membro específico do espaço de trabalho pela sua ID de usuário do Notion. Ela será um UUID com 32 caracteres no seguinte formato: 00000000-0000-0000-0000-000000000000.

  • Observe que meta.createde meta.lastModifiednão refletem valores significativos de data/hora.

• 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>


  • Se o usuário que você está adicionando já tiver uma conta no Notion com o mesmo e-mail, ele será adicionado ao seu espaço de trabalho.

  • Se o usuário não existir, essa chamada criará um novo usuário Notion e adicionará este usuário ao seu espaço de trabalho. Um mapa será enviado para o perfil de usuário Notion que for criado.

  • A API SCIM lerá a propriedade da foto de perfil na criação do usuário, mas não em atualizações futuras.

• 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>

  • Atualiza por meio de uma série de operações e fornece o registro de usuário atualizado.

• 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>

  • Atualiza e retorna o registro do usuário atualizado.

• 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>

  • Remova um usuário do seu espaço de trabalho. O usuário está desconectado de todas as sessões ativas.

    • A conta de usuário não pode ser excluída pelo SCIM. A exclusão da conta deve ser feita manualmente.

    • Também é possível remover um usuário do seu espaço de trabalho definindo o atributo do usuário active como false ao enviar PATCH /Users/<id> ou uma solicitação PUT /Users/<id>.

    • O proprietário do espaço de trabalho que criou o token do bot do SCIM não pode ser removido por meio da API. Quando o proprietário de um espaço de trabalho é removido por meio da API do SCIM, todos os tokens criados por ele serão revogados e todas as integrações que usarem esse bot serão interrompidas.

• 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>


  • Recupere uma lista paginada de grupos do espaço de trabalho.

  • 
    Você pode paginar usando os parâmetros startIndex e count. Observe que startIndex está indexado a 1, e o máximo de count é 100, por exemplo,  <https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=scim mem-invalid-attributes-holder=v2 groups?startindex="1&count=5">


    • Se não for usada paginação, o máximo de 100 grupos de espaços de trabalho retornará em uma solicitação.

  • 
    Você pode filtrar os resultados com o parâmetro filtro.  Os grupos podem ser filtrados por seu atributo displayName,  por exemplo 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>

  • Recupere um membro específico do espaço de trabalho pela sua ID de usuário do Notion. Ela será um UUID com 32 caracteres no seguinte 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>


  • Crie um novo grupo de espaço de trabalho.

• 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>

  • Atualize um grupo de espaço de trabalho por meio de uma série de operações.

• 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>

  • Atualize um grupo de espaço de trabalho.

• 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>

  • Exclua um grupo de espaço de trabalho.