> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.moveworks.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.moveworks.com/_mcp/server.

# How to Configure SharePoint Knowledge Ingestion

<br />

This page is for the **Microsoft Graph and SharePoint Online classic connectors**.

To utilize the new enterprise search configuration experience using the **SharePoint & OneDrive (Max Capacity)** connector, please visit [this documentation](/ai-assistant/enterprise-search/configure-enterprise-search/sharepoint-online-and-onedrive-setup-for-enterprise-search).

### Pre-Requisites

* Please ensure the required SharePoint Connector has been created with the necessary permissions. Please refer the **[SharePoint API Access Requirements Doc](/service-management/access-requirements/knowledge-base-systems/sharepoint-online-access-requirements-new-1)** for details.
* Please ensure the Service Account being used for connecting to SharePoint has access to the **Sites** we want to ingest from.

### Configuration

Start by creating a new Ingestion under **Search > Configure Search > Classic Ingestion > Internal Knowledge**

* First, select the **Connector** which was created for the ingestion and then provide a name for the ingestion. under *Ingestion Name*.
* Then, choose a **Domain**. The domain is the functional areas of employee service that is most related to the knowledge being ingested for this configuration.
* In order to ingest articles from a SharePoint Site, users would need to define the Start URL. They commonly follow the below structure :

  * **Site Pages**
    * `https://<instance-name>.sharepoint.com/sites/<site-name>/_api/SitePages/Pages?$top=10&$skip=0`
    * `https://graph.microsoft.com/beta/sites/<instance-name>.sharepoint.com:/sites/<site-name>:/pages`
  * **Teams Site Pages**
    * `https://graph.microsoft.com/beta/sites/<instance-name>.sharepoint.com:/teams/<teams-site-name>:/pages_`
    * `https://<instance-name>.sharepoint.com/teams/<teams-site-name>/_api/SitePages/Pages?$top=100&$skip=0`

  <br />

  ![](https://files.readme.io/0431bddf383db9b2d374c151534fc910496886366aefcf55ba726bafb920b439-image.png)
* Users also need to provide the Article Url in order for us to generate this for all the ingested Articles. The field that controls this is the **Article Url Override** filed under Field Overrides.

### Validation

* Once you have submitted the Knowledge ingestion configuration, it will kick off the Ingestion pipeline in the background, the status of the same can be tracked on the [Indexed Content View](/ai-assistant/enterprise-search/configure-search/ingested-knowledge/ingested-knowledge-new)
* You can search for the Articles with their Title's here, and if they are listing on the Console that means they have been ingested successfully.
* Please note, only Site Pages in the `Published` state are ingested into the AI Assistant. See [Microsoft documentation](https://support.microsoft.com/en-us/office/management-and-lifecycle-of-a-sharepoint-modern-page-3410a04c-3ca4-4a4c-b867-33ab5c8bdcf3) for more details on Sharepoint page lifecycle.