SharePoint connector

Prerequisites: Firm, Trial, or Enterprise workspace, and a SharePoint site URL you can access. Choose Northdocs Microsoft app or Your own Entra app first. Redirect URI: {APP_URL}/api/connectors/oauth/sharepoint/callback.

Connect one SharePoint site (not the whole tenant), then import into a Northdocs case. Choose which Microsoft app to use first. Setup steps and fields change with your choice.

Connect with the Northdocs Microsoft app

1. 1

   Choose Northdocs Microsoft app

   Choose Northdocs Microsoft app, then continue to Authorize.

2. 2

   Sign in with Microsoft

   Sign in with your Microsoft work account when prompted.

3. 3

   Review the consent screen

   Review the consent screen carefully. Northdocs requests delegated (signed-in user) access: Files.ReadWrite.All and Sites.ReadWrite.All, plus sign-in.

4. 4

   Approve and finish

   Approve, then finish Connect.

Connect with your own Entra app

1. 1

   Create an Entra app registration

   In Microsoft Entra, create an app registration. Multi-tenant is preferred for most firms.

2. 2

   Add delegated Graph permissions

   Under API permissions, add delegated Microsoft Graph permissions as its own step: Files.ReadWrite.All and Sites.ReadWrite.All, plus sign-in (openid, profile, offline_access). Choose Delegated, not Application.

3. 3

   Grant admin consent

   Grant admin consent for your organization for those Files and Sites permissions.

4. 4

   Register the redirect URI

   Add the redirect URI shown on this page (use Copy). Register that exact URI on your Entra app.

5. 5

   Create a client secret

   Create a client secret and copy the Value immediately.

6. 6

   Paste ID and secret

   Paste the Application (client) ID and client secret into the fields on this page. Both are required.

7. 7

   Authorize and finish

   Authorize and finish Connect.

SharePoint site and folder id

SharePoint site URL. The site you can access, for example https://contoso.sharepoint.com/sites/Legal. Do not use the tenant root alone.

Limit to a folder (optional). Leave blank to browse the whole Documents library for this site. Set only if you already have a folder id from IT.

It looks like a long string of letters and numbers (for example 01A2B3C4D5E6F7...), not the folder's web address or display name.

1. Ask your Microsoft 365 admin for the id of the folder you want to limit browse to. It must sit in this site's default Documents library.
2. Paste that id here. If browse fails after connect, clear this field and try again.

If browse fails after connect, clear this field and try again.

Advanced: the value is a Graph drive-item id (shape like b!AbCdEf...).

Imports use the same 100 MB limit and detection pipeline as manual uploads.