> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tess.im/llms.txt
> Use this file to discover all available pages before exploring further.

# SharePoint

The **SharePoint** connector integrates Tess with Microsoft's document management and intranet platform. Once connected, the AI can consult and work with your SharePoint content inside chats and agents, without switching tabs.

SharePoint is part of the Tess [Connectors](/en/connectors) ecosystem and uses **OAuth 2.0** authentication.

## Prerequisites

<Info>
  * Any user can connect SharePoint — you just need an account.
  * You must have a **tenant** configured in SharePoint.
  * You will need to provide the **Tenant Name** and, optionally, the **SharePoint Subsite**.
</Info>

## How to connect

<Warning>
  Before you begin, make sure your SharePoint administrator has already configured and validated the connector permissions. Tess only reflects the permissions defined in SharePoint — without that prior validation, the connection will not complete successfully.
</Warning>

<Warning>
  **Tess will NEVER ask you for administrative permissions.** It only follows what was configured in SharePoint. If any screen requests administrative access on Tess's behalf and it does not match what was previously configured, contact our team for further guidance.
</Warning>

<Steps>
  <Step title="Configure permissions in SharePoint">
    The permissions Tess can access are directly determined by what is configured in your SharePoint. The connector only reflects those permissions — it does not create or expand access.

    A common configuration that can restrict access is the **Site access** section within SharePoint. If a user or group has limited access to a site, the connector will respect that restriction and will not be able to access content beyond what is permitted.

    <Frame>
      <img src="https://mintcdn.com/tess-dfe1edf0/5UwO4QCUNdtDyrhm/images/connectors/sharepoint/06-site-access.png?fit=max&auto=format&n=5UwO4QCUNdtDyrhm&q=85&s=4950baf2bb7cd2a82c554b3a4bbdd42b" alt="SharePoint site access configuration" width="684" height="976" data-path="images/connectors/sharepoint/06-site-access.png" />
    </Frame>

    To review or adjust who has access, open SharePoint, navigate to the desired site, and go to **Site settings** → **Site permissions**.
  </Step>

  <Step title="Open the connector and enter the credentials">
    In the **Connectors** panel, locate SharePoint and click to connect. The credentials form opens.

    * Keep the **Authentication method** as `OAuth 2.0`.
    * In **Tenant Name**, enter only the tenant name (for example, `your-company` for `your-company.sharepoint.com`). Do not paste the full URL.
    * In **SharePoint Subsite** (optional), enter the subsite name that appears in the URL after `/sites/` (for example, `https://tenant.sharepoint.com/sites/<subsite-name>`). Leave it blank to use the root site.

    Click **Connect**.

    <Frame>
      <img src="https://mintcdn.com/tess-dfe1edf0/LSJGxt3kTOVlusby/images/connectors/sharepoint/01-credentials.png?fit=max&auto=format&n=LSJGxt3kTOVlusby&q=85&s=5e475282828605da840b88b231d12c48" alt="SharePoint connector credentials form" width="723" height="780" data-path="images/connectors/sharepoint/01-credentials.png" />
    </Frame>
  </Step>

  <Step title="Grant the permissions (admin consent)">
    If the account is **not an administrator**, Microsoft displays an **Admin approval required** screen. In that case, sign in with an administrator account or ask an administrator to grant permission to the application.

    <Frame>
      <img src="https://mintcdn.com/tess-dfe1edf0/LSJGxt3kTOVlusby/images/connectors/sharepoint/02-not-admin.png?fit=max&auto=format&n=LSJGxt3kTOVlusby&q=85&s=a934853e0c137a5bec31429803ef305a" alt="Admin approval required screen" width="431" height="361" data-path="images/connectors/sharepoint/02-not-admin.png" />
    </Frame>

    If the account **is an administrator** (or already has the permission), Microsoft shows the **Permissions requested** screen. Review the listed permissions and confirm to authorize access.

    <Frame>
      <img src="https://mintcdn.com/tess-dfe1edf0/5UwO4QCUNdtDyrhm/images/connectors/sharepoint/03-admin-consent.png?fit=max&auto=format&n=5UwO4QCUNdtDyrhm&q=85&s=48a6451ce2ef0566f2ace575952a1bf6" alt="Composio - SharePoint permissions consent screen" width="443" height="318" data-path="images/connectors/sharepoint/03-admin-consent.png" />
    </Frame>

    <Info>
      The permissions shown on this screen are defined by your organization's SharePoint configuration — Composio acts as a bridge and simply reflects the permissions already set in your tenant. You are not granting new permissions; you are authorizing Composio to use the ones already defined.

      The access scope can also be limited by the **Site access** settings within SharePoint. If certain users or groups have restricted access to a site, that restriction is respected by the connector — Composio cannot access content beyond what SharePoint allows for that account.

      To review or adjust site access permissions, open SharePoint, go to **Site settings** → **Site permissions**, and check the configured groups and permission levels.
    </Info>
  </Step>

  <Step title="Connection confirmation">
    After authorizing, the Tess callback window shows the **Connected successfully!** message and closes automatically after a few seconds.

    <Frame>
      <img src="https://mintcdn.com/tess-dfe1edf0/LSJGxt3kTOVlusby/images/connectors/sharepoint/04-connected.png?fit=max&auto=format&n=LSJGxt3kTOVlusby&q=85&s=81ab17024f218b006b41435cf7c89cd9" alt="Connector authorization success window" width="556" height="702" data-path="images/connectors/sharepoint/04-connected.png" />
    </Frame>
  </Step>

  <Step title="Confirm SharePoint is active">
    Back in the **Connectors** panel, SharePoint appears under the **Connected** section, with a green check mark indicating it is active and ready to use in chats and agents.

    <Frame>
      <img src="https://mintcdn.com/tess-dfe1edf0/LSJGxt3kTOVlusby/images/connectors/sharepoint/05-active.png?fit=max&auto=format&n=LSJGxt3kTOVlusby&q=85&s=e724f34ff873fae4e1365267b97076d0" alt="SharePoint active in the connectors list" width="385" height="283" data-path="images/connectors/sharepoint/05-active.png" />
    </Frame>
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="The connection keeps loading and ends in a timeout" icon="circle-exclamation">
    Check that **Tenant Name** was filled in with only the tenant name (for example, `your-company`) and **not** the full URL (`your-company.sharepoint.com`). An incorrect value can cause Microsoft to return an invalid resource error during OAuth.
  </Accordion>

  <Accordion title="The admin approval required screen appears" icon="user-shield">
    The application needs permissions that only an administrator can grant. Ask the SharePoint administrator to sign in first through the connector and grant authorization; after that, other users can connect.
  </Accordion>

  <Accordion title="Environment with federated SSO, IP allowlist, or client certificate" icon="building-lock">
    In organizations with an additional federated domain after SSO (with IP blocks or a client certificate requirement on the device), the connection may fail due to corporate environment restrictions. In these cases, a technical alignment with the infrastructure team is required to validate the IdP, federated domains, IP allowlist, and certificates.
  </Accordion>
</AccordionGroup>

<Note>
  Connectors involve access to external systems. Only connect accounts and apps that are appropriate to the usage context, and review permissions carefully.
</Note>
