> For the complete documentation index, see [llms.txt](https://help.tellius.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.tellius.com/tellius-6.4/kaiya/ask-across-your-documents-unstructured/how-to-connect-to-unstructured-data/connect-to-sharepoint.md).
# Connect to SharePoint
Connect Tellius to Microsoft SharePoint so Kaiya can search your SharePoint files: sign in with OAuth or use a service key, pick the search scope, and set how often the files sync.
On the **Unstructured** tab of **Add new connectors**, selecting **SharePoint** opens the **Add a connection** dialog. Its **Connection Details** section reads "Connect to SharePoint to access and sync your files". Once the connection syncs, Kaiya can search the files it brings in.
**Connection Name** (required): A unique name that identifies this connection in the Unstructured connections list.
**Description:** A short note on what the connection is used for, for example which team's documents it brings in.
**Authentication Method:** How Tellius signs in to SharePoint. **OAuth** is selected by default.
* **OAuth:** When you select **Connect**, Tellius sends you to Microsoft to sign in, and then returns you to this page.
* **Service Key:** You enter the credentials of a Microsoft app registration instead of signing in. Four required fields appear; see [Service Key fields](#service-key-fields) below.
**Search Scope:** Shown with **OAuth** only. It sets which SharePoint locations the connection covers. The values are **All** (selected by default), **Accessible Drives** and **SharePoint Default Drive**.
{% hint style="info" %}
**OAuth or Service Key?** **OAuth** signs in to SharePoint with a Microsoft account, in the browser, when you connect. **Service Key** uses an app registration instead, so pick it when your Microsoft administrator has set one up and can give you its Tenant ID, Client ID and Client Secret.
{% endhint %}
### Service Key fields
When **Authentication Method** is **Service Key**, the dialog shows these fields in place of **Search Scope**. All four are required, and what you type is masked.
* **Tenant ID:** The Directory (tenant) ID of your Microsoft Entra ID (Azure AD) tenant.
* **Client ID:** The Application (client) ID of the app registration that Tellius uses.
* **Client Secret:** The secret created for that app registration.
* **User Principal Name:** The sign-in name of a Microsoft user, in the form `user@example.onmicrosoft.com`.
### Scheduled Sync
The **Schedule Type** dropdown sets how often Tellius syncs files from SharePoint.
* **Manual:** Tellius syncs only when you select **Synchronize** in the connection's row menu on the Unstructured tab.
* **Schedule:** Tellius syncs on a schedule. A **Cron Schedule (UTC)** dropdown appears with **Hourly**, **Every 6 hours**, **Daily at midnight**, **Daily at 2 AM** and **Every 12 hours**. All times are in UTC, so allow for your time zone.
{% hint style="info" %}
Match the schedule to how often new files arrive in SharePoint. A busy document library suits **Hourly** or **Every 6 hours**; a library that changes once a week is fine with a daily schedule or **Manual**.
{% endhint %}
### Create the connection
Select **Connect** to create the connection, or **Cancel** to discard it. With **OAuth**, Tellius first sends you to Microsoft to sign in.
The new connection appears on the **Unstructured** tab with the type **SharePoint**. From its row menu you can **Edit** it (the dialog is then titled **Edit Connection** and the button reads **Save**), **Synchronize** it, **Share** it or **Delete** it. See [Ask across your documents (Unstructured)](https://help.tellius.com/kaiya/ask-across-your-documents-unstructured).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://help.tellius.com/tellius-6.4/kaiya/ask-across-your-documents-unstructured/how-to-connect-to-unstructured-data/connect-to-sharepoint.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
