SharePoint
Connect to your users' SharePoint accounts
Setup Guide
You can find your SharePoint application credentials by visiting your Microsoft Azure Portal.
You'll need the following information to set up your SharePoint app with Paragon Connect:
- Client ID
- Client Secret
- Scopes Requested
Prerequisites
Add the Redirect URL to your SharePoint app
Paragon provides a redirect URL to send information to your app. To add the redirect URL to your SharePoint app:
1. Copy the link under "Redirect URL" in your integration settings in Paragon. The Redirect URL is:
1
https://passport.useparagon.com/oauth
Copied!
3. Navigate to All Services > App Registrations and select your application.
4. Select Authentication from the sidebar.
5. Under Platform configurations, press the "Add a platform" button.
6. Select the Web platform.
7. Paste the Redirect URL from Step 1 under Redirect URIs.
8. Press the Save button at the top of the page.
Generate a Client Secret
Since SharePoint does not automatically provide you with a Client Secret for your application, we'll need to make one. To get your Client Secret:
1. Navigate to Manage > Certificates & secrets in the sidebar.
2. Under Client Secrets, press the + New client secret button.
3. Name your client credentials and select an expiry that works best for your application. Press Add to create your credentials.
4. Copy the displayed Client Secret under the Value column.
Add your SharePoint app to Paragon
1. Select SharePoint from the Integrations Catalog.
- Client ID: Found under Essentials > Application (client) ID on your Microsoft Azure Portal app page.
- Permissions: Select the scopes you've requested for your application.
Press the blue "Connect" button to save your credentials.
Note: You should only add the scopes you've requested in your application page to Paragon.
Connecting to SharePoint
Once your users have connected their SharePoint account, you can use the Paragon SDK to access the SharePoint API on behalf of connected users.
Any SharePoint API endpoints can be accessed with the Paragon SDK as shown in this example.
1
// You can find your project ID in the Overview tab of any Integration
2
​
3
// Authenticate the user
4
paragon.authenticate(<ProjectId>, <UserToken>);
5
​
6
// Get organization’s default site
7
await paragon.request("sharepoint", "/sites/root", {
8
method: "GET",
9
});
10
​
11
​
12
// Get list under a site
13
await paragon.request("sharepoint", "/sites/{site-id}/lists", {
14
method: "GET",
15
});
16
​
17
// Create task in list
18
await paragon.request("sharepoint", "sites/{site-id}/lists/{list-id}/items", {
19
method: "POST",
20
body: {
21
"fields": {
22
"Title": "Widget",
23
"Color": "Purple",
24
"Weight": 32
25
}
26
}
27
});
Copied!
Building SharePoint workflows
Once your SharePoint account is connected, you can add steps to perform the following actions:
- Create Item
- Update Item
- Get Item by ID
- Get Items in a List
- Delete Item
- Create List
- Get List by ID
- Get Lists
- Create List column
- Get List columns
- Get default site
- Search sites
- Get subsites in a site
When creating messages in SharePoint, you can reference data from previous steps by typing
{{ to invoke the variable menu.Last modified 1mo ago