In this article
Overview
Use this account type to connect SharePoint online Snaps that use SharePoint Online Account.
Prerequisites
Valid Azure application with all the required API permissions.
Valid client ID and client secret.
Limitations and Known Issues
None.
Account Settings
| Parameter | Data Type | Description | Default Value | Example |
|---|---|---|---|---|
Label | String | Unique name for the account. | None | Sharepoint online OAuth2 Dev |
Client ID | String | Required. The client ID associated with your Azure application. You can create the client ID as advised by your application provider | N/A | c3fb6e88-9ec0-468f-ba06-cc94525a8f1d |
Client secret | String | Required. The client secret associated with your account. You can create the client secret as advised by your application provider. | N/A | N/A |
Access token | String | Required. Auto-generated after authorization. The access token associated with the Azure application is used to make API requests on behalf of the user associated with the client ID. | N/A | N/A |
Refresh token | String | Required. The refresh token retrieval for the application is specified when setting up the account for the endpoint. There, the OAuth2 flow will be executed and the resulting refresh token can be stored in this property. If the refresh token is stored, then the access token can be refreshed automatically before it expires. | N/A | N/A |
Access token expiration | Integer | The access token expiration value. | N/A | N/A |
OAuth2 Endpoint | String | Required. Authorization endpoint to authorize the application. | https://login.microsoftonline.com/<tenantName>.onmicrosoft.com/oauth2/v2.0/authorize | |
OAuth2 Token | String | Required. Token endpoint to get the access token. | https://login.microsoftonline.com/{tenantName}.onmicrosoft.com/oauth2/v2.0/token | N/A |
Token endpoint config | Use this fieldset to provide custom properties for the OAuth2 token endpoint. Click the + or - icons to respectively add or remove configuration rows. | |||
Token endpoint parameter | String | Defines an optional token endpoint parameter value. | N/A | response_type |
Token endpoint parameter value | String | Provides custom properties for the OAuth2 auth endpoint. | N/A | code |
| Auth endpoint config | Use this field set to provide custom properties for the OAuth2 auth endpoint. Click the + or - icons to respectively add or remove configuration rows. | |||
Auth endpoint parameter | String | Defines an optional authentication parameter. | N/A | scope |
Auth endpoint value | String | Defines an optional authentication parameter value. | N/A | offline_access Sites.ReadWrite.All |
Auto-refresh token | Checkbox | Refreshes the token automatically using the refresh token if the property is enabled. Otherwise, the token might expire and will not be automatically refreshed. | Disabled | N/A |
Troubleshooting
| Error | Reason | Resolution |
|---|---|---|
| Authentication failed. | You have entered an incorrect client-id or client-secret. | Check your client-id and client-secret. |
Release | Snap Pack Version | Date | Type | Updates |
|---|---|---|---|---|
February 2024 | main168 |
| Stable | Updated and certified against the current SnapLogic Platform release. |
November 2023 | main155 |
| Stable | Updated and certified against the current SnapLogic Platform release. |
August 2023 | main150 |
| Latest | Added pagination in the List Read Items Snap. Also added suggestions for the List name field. |
August 2023 | main144 |
| Latest | The Upload File Snap now supports files larger than 2 GB. |
August 2023 | main138 |
| Stable | Updated and certified against the current SnapLogic Platform release. |
May 2023 | main130 |
| Stable | Upgraded with the latest SnapLogic Platform release. |
February 2023 | main114 | 09 Feb 2023 | Stable | Upgraded with the latest SnapLogic Platform release. |
November 2022 | main113 | 10 Nov 2022 | Stable | Upgraded with the latest SnapLogic Platform release. |
August 2022 | main111 | 11 Aug 2022 | Stable | Added the SharePoint Online Application Account type that supports Client Credentials flow. |
4.29 | main108 | 14 May 2022 | Stable | Upgraded with the latest SnapLogic Platform release. |
4.28 Patches | main101 | 06 Apr 2022 | Latest | Fixed the Auto Refresh Token issue in the SharePoint Online Account. |
4.28 | main100 | 12 Feb 2022 | Stable | Added the SharePoint Online - Get Sites Snap that enables you to get the list of sites specific to the logged-in user from the SharePoint Online site. |
4.27 | main93 | 13 Nov 2021 | Stable | Upgraded with the latest SnapLogic Platform release. |
4.26 | main89 | 30 Aug 2021 | Latest | Enhanced all Snaps in the SharePoint Online Snap Pack to support dynamic site and document library values using input document variables. |
4.26 | main88 | 14 Aug 2021 | Stable | Upgraded with the latest SnapLogic Platform release. |
4.25 | main75 | 08 May 2021 | Stable | No updates made. |
4.24 | main75 | 13 Feb 2021 | Stable | No updates made. |
4.23 | main74 | 02 Dec 2020 | Latest | Fixes the error view issue in SharePoint Online - Upload File Snap by dragging a new instance of SharePoint Online - Upload File Snap to the canvas as the existing Snap that was used with a version that contained the bug will continue to fail. |
4.23 | main74 | 16 Nov 2020 | Latest | Fixes the socket timeout issue in the Snap Pack by making the following changes:
|
4.23 | main73 | 15 Nov 2020 | Latest | Introduces a new Snap, SharePoint Online - List Read Items Snap, that enables you to read, sort, and filter list items from your SharePoint Online libraries/collections. |
4.22 Patches | main39 | 23 Oct 2020 | Stable | Fixes the Snap document link for SharePoint Online - List Read Items. |
4.22-Patches | 422patches6694 | 14 Sep 2020 | Latest |
|
4.22 | main6403 | 08 Aug 2020 | Stable | No updates made. |
4.21-Patches | 421patches6011 | 23 Jun 2020 |
| Introduces the productized version of SharePoint Online Snap Pack, which enables organizations to share and manage content and collaborate across an organization |
4.21 |
| 10 May 2020 | Latest | Beta release of the SharePoint Online Snap Pack |