SharePoint Integration Setup

Overview

Findable connects to your Microsoft SharePoint using the Microsoft Graph API. Once connected, Findable monitors your SharePoint sites for changes and automatically mirrors documents into the Findable platform for AI-powered classification, search, and organization.

Here’s what happens under the hood:

• Findable registers a subscription for your selected SharePoint sites and drives
• When files are added or changed in SharePoint, Findable is notified automatically
• Documents are imported and processed by Findable’s AI — classified, tagged, and made searchable
• For custom integrations, Findable can also write files and metadata back to SharePoint

Findable respects Microsoft’s API rate limits and processes changes on a per-tenant basis to ensure reliability.

Security & Permissions

Findable authenticates to the Microsoft Graph API via an App Registration in your Microsoft Entra ID (formerly Azure AD). Your IT team controls exactly what Findable can access.

Two access modes

Mode	Permission	What it does
Full Access	Sites.Read.All	Read access to all SharePoint sites in your tenant. Use Sites.ReadWrite.All if Findable should also write files/metadata back to SharePoint.
Limited Access	Sites.Selected	Access only the specific SharePoint sites you explicitly grant. Recommended for organizations that want granular control.

How authentication works: A client secret is created for the app registration. This secret is encrypted at rest and only shared with Microsoft’s token service to obtain access tokens. All subsequent API requests use these short-lived tokens.

---

Setup Guide

You’ll need an administrator of your organization’s Microsoft Entra ID to complete these steps. The entire process takes about 15 minutes.

Step 1: Create the App Registration

1. Sign in to the Microsoft Entra admin center and navigate to App registrations → New registration.

   

2. Give the application a name (e.g., “Findable SharePoint Integration”) and keep the default values for the remaining fields. Click Register.

   Make note of the Application (client) ID — you’ll need this later.

   

3. Navigate to Certificates & secrets in the left sidebar, then click New client secret.

   

4. Add a description (e.g., “Findable integration”) and select an expiration period. Click Add.

   

5. Important: Copy the Value of the client secret immediately. This is only shown once. Also note the Secret ID.

   

Step 2: Grant API Permissions

1. Navigate to API permissions in the left sidebar, then click Add a permission.

   

2. Select Microsoft Graph.

   

3. Choose Application permissions (not delegated).

   

4. Choose your access level:

   • Option A — Full Access: Search for and select Sites.Read.All (or Sites.ReadWrite.All if Findable should write back to SharePoint). If you choose this option, skip ahead to Step 3.
   • Option B — Limited Access: Search for and select Sites.Selected. Continue with step 5 below.

   

5. (Sites.Selected only) Open the Microsoft Graph Explorer and sign in with your admin account.

   

6. (Sites.Selected only) Find the ID of the SharePoint site you want Findable to access. Send a GET request to:

   https://graph.microsoft.com/v1.0/sites/{tenant-name}.sharepoint.com:/sites/{site-name}

   Replace {tenant-name} with your organization’s SharePoint tenant name and {site-name} with the site name (remove any spaces).

   Copy the id from the response.

   

7. (Sites.Selected only) Grant Findable access to this site by sending a POST request to:

   https://graph.microsoft.com/v1.0/sites/{site-id}/permissions

   With this request body:

   {
     "roles": ["read"],
     "grantedToIdentities": [
       {
         "application": {
           "id": "{application-id}",
           "displayName": "{application-name}"
         }
       }
     ]
   }

   Replace {site-id}, {application-id}, and {application-name} with your values. Use "write" instead of "read" if Findable should have write access.

   

8. Repeat steps 6-7 for each SharePoint site you want Findable to access.

Step 3: Enter Credentials in Findable

1. Sign in to app.findable.ai with an account that has administrator permissions in your Findable organization.

2. Navigate to any building in your portfolio.

   

3. Open Building Settings → Integrations → SharePoint.

   

   

4. Enter your credentials:

   • Tenant ID — Your Microsoft 365 tenant ID
   • Client ID — The Application (client) ID from Step 1
   • Client Secret — The secret value you copied in Step 1

   Click Save.

   

5. Click Test to verify the connection. You can now create SharePoint subscriptions for any building in your organization.

---

Need Help?

If you run into issues during setup, reach out to our team at support@findable.ai or use the chat widget in the bottom-right corner of the Findable app.