Configuring your SharePoint OAuth app

Set up your OAuth application in 9 steps

Step 1

Begin creating an OAuth app in the Writer web app.

How to create an OAuth app: https://support.writer.com/article/251-setting-up-knowledge-graph-data-connectors#Setting-up-OAuth-app-permissions-g1eUX

You'll need to fill in the OAuth application values for this popup below.

For Application name, you can use whichever you prefer. This application name will appear on the Knowledge Graph setup page as team admins set up graphs for their teams.

To fill in Client ID and Client secret, you'll need to head over to Microsoft Azure and follow the remaining steps below.

Step 2

Log into Microsoft Azure (you’ll need to be an Azure Admin).

Step 3

Go to Azure Services. Then, select App Registration, followed by New registration.

Step 4

On the following screen, select supported account types.

Select Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant).

Step 5

For Redirect URI, enter: https://app.writer.com/connector/sharepoint

Step 6

Next, you’ll need to request API permissions for your application. Head to Manage, then API permissions, and select Microsoft Graph. Add permissions for:

1. Sites.Read.All
2. User.Read

Step 7

To enable the file picker, you need to allow tokens to be issued by the authorization endpoint. Be sure to check these two boxes: Access tokens (used for implicit flows), and ID tokens (used for implicit and hybrid flows)

Step 8

Next, you’ll need to add the client secret ID and value to your OAuth app in the Writer web app under the Client Secret field.

Head to Client credentials. Select Add a certificate or secret.

Then, select New Client Secret. Copy the Value field to your clipboard and add it to your Writer OAuth app in the Client Secret field.

Step 9

Finally, you'll need to copy the Application ID from Azure and paste it into the Client ID field in the Writer OAuth app popup.