SharePoint Integration Set-Up

How to integrate your SharePoint with your Mindset App

With this integration, we can sync data from your SharePoint into our knowledge banks. We will ingest all content from a folder in a SharePoint site or we can ingest the entirety of a site into a knowledge bank and automatically sync updates every week. Any new files will be added, any deleted files will be removed, and any updated files will be updated—ensuring your knowledge bank always stays up to date.

File formats supported

📄 Documents: Google Docs, DOCX, PDF, txt 📊 Presentations: Google Slides, PPTX 🎵 Audio: MP3 🎥 Video: MP4

File size limit

See our page on file size limits here.

Can we ingest from subfolders?

✅ Yes! By default we will ingest all content from any subfolders within the site or folder we are ingesting from.

We ingest subfolders but it makes the deletion process more difficult depending on your setup, if you experience issues, reach out to us at [e-mail].

Permissions Required

You will need to authorize our Azure app and then specify which sites we can access.

We use Sites.Selected permissions, meaning we do not have default access to any sites—you must explicitly grant access to specific sites.

Step-by-step instructions

You will need Sharepoint Admin access rights to follow the process below. We recommend jumping on a call with our Solutions Engineer to go through this process.

Step 1: Sharing your tenant ID with us.

First you will need to share your tenant ID with us.

How to find your Microsoft Entra tenant

1. Sign in to the Azure portal.
2. Confirm that you are signed into the tenant for which you want to retrieve the ID. If not, switch directories so that you're working in the right tenant.
3. Under the Azure services heading, select Microsoft Entra ID. If you don't see Microsoft Entra ID here, use the search box to find it.

4. Find the Tenant ID in the Basic information section of the Overview screen.

5. Copy the Tenant ID and send this to us.

You can also find your tenant programmatically by using Azure Powershell

Step 2: Authorize our Azure App on your tenant

Once we have your Tenant ID, we will send you an authorization link.

1. Open the provided link.

2. Sign in as a Microsoft admin.

3. Click Accept to authorize the integration.

This allows our app to securely connect to your SharePoint environment.

Step 3: Get the Site ID for the SharePoint Sites You Want to Sync

We need the Site ID of each SharePoint site you want us to access.

How to Retrieve a Site ID

1. Open Microsoft Graph Explorer and sign in as an admin.
2. Run the following GET request: https://graph.microsoft.com/v1.0/sites/{sharepoint_url}:/sites/{site_name}

   1. {sharepoint_url} is your SharePoint root domain (e.g., companyname.sharepoint.com).

   2. {site_name} is the exact name of the site (visible in the URL when navigating the SharePoint site).

3. Look for the Site ID in the response.

💡 If you get a permissions error, you may need to temporarily grant Sites.FullControl.All in Graph Explorer to retrieve the Site ID.

Step 4: Grant Our App Access to the Selected Sites

Once you have the Site ID, you must explicitly grant access to our app by making a POST request in Microsoft Graph Explorer.

How to Grant Access

1. Run the following POST request: https://graph.microsoft.com/v1.0/sites/{site_id}/permissions
2. Use this JSON body:

{
    "roles": [
        "read"
    ],
    "grantedToIdentities": [
        {
            "application": {
                "id": "{client_id}",
                "displayName": "{App Name}"
            }
        }
    ]
}

• roles: We request "read" access by default (this allows us to view files but not modify them).

• client_id and App Name will be provided by Mindset.

Important: You must repeat this request for each site you want to sync.

Step 5: Share the Site IDs with Mindset

After granting access, share the Site IDs with us and specify which folders or drives should be ingested.

Example Submission Format:

Site ID	Ingested Content
xxxxx	All drives & folders
yyyyy	Drive A (all folders), Drive B (folders X, Y, Z)

This ensures we only sync the data you need.

Step 6: Integration Setup & Syncing

Once access is confirmed, our team will configure the integration for you. Your knowledge bank will now automatically sync weekly.

Adding More Folders or Sites Later?

If you want to sync additional folders, just email [e-mail], and we’ll set up the process for you.

Best Practices for Selecting Data

• Quality over quantity!

  • When choosing what to sync, focus on the most relevant and useful data rather than uploading everything.

• Think of it like training your agent

  • A well-trained agent performs better with focused, high-quality information rather than an overwhelming amount of general data.

• Avoid unnecessary clutter

  • The more targeted your content, the more accurate and helpful your agent’s responses will be.

• Avoid duplicates

  • The agent won’t recognize duplicates and may recommend the same file more than once.