SharePoint Online (Client Credentials V2)

Overview

Pre-built tooling

Pre-built integrations

Access requirements

Setup guide

Useful links

API gotchas

Pre-built tooling

✅ Authorization

Tools	Status
Pre-built authorization (OAuth)	✅
Credentials auto-refresh	✅
Auth parameters validation	✅
Pre-built authorization UI	✅
Custom authorization UI	✅
Expired credentials detection	✅

✅ Read & write data

Tools	Status
Pre-built integrations	✅
API unification	✅
2-way sync	✅
Webhooks from Nango on data modifications	✅
Real-time webhooks from 3rd-party API	🚫 (time to contribute: <48h)
Proxy requests	✅

✅ Observability & data quality

Tools	Status
HTTP request logging	✅
End-to-end type safety	✅
Data runtime validation	✅
OpenTelemetry export	✅
Slack alerts on errors	✅
Integration status API	✅

✅ Customization

Tools	Status
Create or customize use-cases	✅
Pre-configured pagination	🚫 (time to contribute: <48h)
Pre-configured rate-limit handling	🚫 (time to contribute: <48h)
Per-customer configurations	✅

Others

Function name	Description	Type	Source code
`add-content-type-to-list`	Associate a content type with a SharePoint list.	Action	🔗 Github
`add-drive-item-permission`	Invite users or groups to access a drive item.	Action	🔗 Github
`copy-drive-item`	Copy a file or folder to another location in a site drive.	Action	🔗 Github
`create-content-type`	Create a content type on a SharePoint site.	Action	🔗 Github
`create-drive-folder`	Create a folder in a SharePoint document library.	Action	🔗 Github
`create-drive-upload-session`	Start a large file upload session in a site drive.	Action	🔗 Github
`create-list-column`	Create a column on a SharePoint list.	Action	🔗 Github
`create-list-item`	Create an item in a SharePoint list.	Action	🔗 Github
`create-list`	Create a SharePoint list on a site	Action	🔗 Github
`create-sharing-link`	Create a shareable link for a drive item.	Action	🔗 Github
`create-site-column`	Create a site-level column definition on a SharePoint site.	Action	🔗 Github
`create-site-page`	Create a modern site page.	Action	🔗 Github
`delete-content-type`	Delete a content type from a SharePoint site.	Action	🔗 Github
`delete-drive-item`	Delete a file or folder from a site drive.	Action	🔗 Github
`delete-list-column`	Delete a column from a SharePoint list.	Action	🔗 Github
`delete-list-item`	Delete an item from a SharePoint list.	Action	🔗 Github
`delete-list`	Delete a SharePoint list.	Action	🔗 Github
`delete-site-column`	Delete a site-level column definition.	Action	🔗 Github
`delete-site-page`	Delete a site page.	Action	🔗 Github
`download-drive-item-content`	Download the file content of a SharePoint drive item	Action	🔗 Github
`get-content-type`	Retrieve a single content type from a SharePoint site.	Action	🔗 Github
`get-drive-item-thumbnail`	Retrieve thumbnail URLs for a drive item.	Action	🔗 Github
`get-drive-item`	Retrieve a file or folder from a site drive.	Action	🔗 Github
`get-drive`	Retrieve a site drive by ID.	Action	🔗 Github
`get-list-item`	Retrieve a SharePoint list item by ID.	Action	🔗 Github
`get-list`	Retrieve a SharePoint list by ID.	Action	🔗 Github
`get-site-page`	Retrieve a site page by ID.	Action	🔗 Github
`get-site`	Retrieve a SharePoint site by ID or path.	Action	🔗 Github
`list-content-types`	List content types defined on a SharePoint site.	Action	🔗 Github
`list-drive-children`	List items under a folder in a site drive.	Action	🔗 Github
`list-drive-item-permissions`	List all permissions on a drive item.	Action	🔗 Github
`list-drive-item-versions`	List the version history of a drive item.	Action	🔗 Github
`list-drives`	List document libraries on a site.	Action	🔗 Github
`list-list-columns`	List columns on a SharePoint list.	Action	🔗 Github
`list-list-content-types`	List the content types associated with a SharePoint list.	Action	🔗 Github
`list-list-items`	List items in a SharePoint list	Action	🔗 Github
`list-lists`	List SharePoint lists on a site.	Action	🔗 Github
`list-shared-sites`	List SharePoint sites for user selection workflows.	Action	🔗 Github
`list-site-columns`	List site-level column definitions on a SharePoint site.	Action	🔗 Github
`list-site-pages`	List modern site pages on a site.	Action	🔗 Github
`publish-site-page`	Publish a site page.	Action	🔗 Github
`remove-drive-item-permission`	Remove a permission from a drive item.	Action	🔗 Github
`restore-drive-item-version`	Restore a previous version of a drive item.	Action	🔗 Github
`search-drive-items`	Search for files and folders within a site drive.	Action	🔗 Github
`search-sites`	Search for sites by keyword.	Action	🔗 Github
`update-drive-item-permission`	Update an existing permission on a drive item.	Action	🔗 Github
`update-drive-item`	Rename or move a file or folder in a site drive.	Action	🔗 Github
`update-list-column`	Update a SharePoint list column.	Action	🔗 Github
`update-list-item`	Update fields on a SharePoint list item.	Action	🔗 Github
`update-list`	Update mutable list properties.	Action	🔗 Github
`update-site-column`	Update a site-level column definition.	Action	🔗 Github
`update-site-page`	Update a modern site page draft.	Action	🔗 Github
`upload-drive-item`	Upload small file content directly to a site drive (≤4 MB). For larger files use create-drive-upload-session.	Action	🔗 Github
`content-types`	Sync content type definitions for configured sites.	Sync	🔗 Github
`drive-item-versions`	Sync version history for drive items in configured site drives	Sync	🔗 Github
`drive-items`	Sync files and folders from selected site drives	Sync	🔗 Github
`drives`	Sync document libraries for selected sites	Sync	🔗 Github
`list-columns`	Sync SharePoint list schemas.	Sync	🔗 Github
`list-items`	Sync items from selected SharePoint lists.	Sync	🔗 Github
`lists`	Sync SharePoint lists for selected sites.	Sync	🔗 Github
`permissions`	Sync permission grants on drive items for configured site drives.	Sync	🔗 Github
`shared-sites-selection`	Sync selected files from chosen SharePoint shared sites.	Sync	🔗 Github
`site-columns`	Sync site-level column definitions for configured sites.	Sync	🔗 Github
`site-pages`	Sync modern site pages for selected sites.	Sync	🔗 Github
`sites`	Sync targeted SharePoint sites.	Sync	🔗 Github
`subsites`	Sync subsites under selected parent sites.	Sync	🔗 Github
`user-files-selection`	Sync selected user files from SharePoint.	Sync	🔗 Github
`user-files`	Sync file metadata from user-accessible SharePoint files.	Sync	🔗 Github

Access requirements

Pre-Requisites	Status	Comment
Paid dev account	❓
Paid test account	❓
Partnership	❓
App review	❓
Security audit	❓

Setup guide

No setup guide yet.

Need help getting started? Get help in the community.

Contribute improvements to the setup guide by editing this page

Useful links

Contribute useful links by editing this page

API gotchas

Nango supports both SharePoint Online v1 and v2, providing flexibility for integrations depending on your requirements. SharePoint v1 refers to the older REST API, which uses legacy authentication methods like SharePoint Online (SPO) or older OAuth implementations. Its endpoints follow the pattern https://<your-tenant>.sharepoint.com/_api/, and it supports basic SharePoint operations. However, v1 lacks modern features such as delta queries for incremental sync and deep integration with Microsoft 365.
Sharepoint Online v2, on the other hand, is a modernized version aligned with the Microsoft Graph API. It uses OAuth 2.0 with the Microsoft Identity Platform (formerly Azure AD) for secure and scalable authentication. Endpoints for v2 are primarily accessed through https://graph.microsoft.com/v1.0/sites/..., and it offers advanced capabilities like delta queries for incremental sync, enhanced performance, and seamless integration with Microsoft 365 services.

Contribute API gotchas by editing this page

Connect to SharePoint Online (Client Credentials V2)

Guide to connect to SharePoint Online (Client Credentials V2) using Connect UI

​Overview

Pre-built tooling

Pre-built integrations

Access requirements

Setup guide

Useful links

API gotchas

​Pre-built tooling

​Others

​Access requirements

​Setup guide

​Useful links

​API gotchas

Connect to SharePoint Online (Client Credentials V2)

Overview

Pre-built tooling

Others

Access requirements

Setup guide

Useful links

API gotchas