Skip to main content

Microsoft SharePoint Component

Interact with sites, drives, and items connected to your instance of Microsoft SharePoint.

Component key: ms-sharepoint

Changelog ↓

Description​

Microsoft SharePoint is a web-based collaborative platform that integrates with Microsoft Office. This component allows you to interact with your sites, drives, and items by making queries through the Microsoft Graph API.

API Documentation​

This component was built using the Microsoft Graph Rest API v1.0

Example SharePoint Integration​

The examples repo has an example integration that you can import that demonstrates how to listen for changes to a SharePoint drive, or fetch lists and items from a SharePoint site.

Example Integration

This example integration contains five flows:

  • Import SharePoint File on Event - Whenever a file is created/updated/deleted in your customer's selected Sharepoint drive, that file is fetched and uploaded to an "Acme" endpoint that your customer enters.
  • Subscribe to SharePoint File Events - This flow runs every week and creates a subscription to a Sharepoint drive, instructing Sharepoint to send notifications to the Import SharePoint File on Event flow whenever files are updated.
  • Run Subscription Flow on Deploy - This flow calls the Subscribe to SharePoint File Events once on instance deploy to ensure the subscription is configured immediately.
  • Get Files from SharePoint - This is a synchronous flow that can be called from an external system to list files in a SharePoint drive.
  • Fetch Events and Documents from Site Lists - This flow demonstrates how to fetch "lists" in a SharePoint site,. A "list" can represent a calendar of events or a directory with files in it.

Connections​

Certificate Credentials​

App Registration Requirements​

First, create an app registration in Microsoft Entra by following the steps in the OAuth connection guide. Then configure the following Microsoft Graph Application permissions:

Site Operations:

  • Sites.Read.All - Read items in all site collections
  • Sites.ReadWrite.All - Read and write items in all site collections
  • Sites.Manage.All - Create, edit, and delete items and lists in all site collections
  • Sites.FullControl.All - Full control of all site collections

File Operations:

  • Files.Read.All - Read files in all site collections
  • Files.ReadWrite.All - Read and write files in all site collections

List Operations:

  • Sites.ReadWrite.All - Required for list operations
  • Sites.Manage.All - For creating and managing lists

User and Group Access:

  • User.Read.All - Read all users' profiles
  • Group.Read.All - Read all groups

Certificate Requirements​

Before configuring certificate credentials, ensure:

  • Certificate issued by a Certificate Authority (CA) for production, or self-signed for development
  • RSA key size: minimum 2048 bits (4096 bits recommended)
  • Certificate in X.509 format
  • Public key formats: .cer, .pem, or .crt
  • Private key in PEM or PKCS#12 format

Registering Certificate with Azure​

  1. Ensure app registration is complete with required permissions
  2. Navigate to Certificates & Secrets in the app registration
  3. Select the Certificates tab
  4. Click Upload certificate
  5. Select the public certificate file (.cer, .pem, or .crt)
  6. Add an optional description
  7. Click Add to upload

After upload, note these values:

  • Certificate Thumbprint - SHA-1 hash (e.g., "931E8F84B98A4B5F93AD609FD5E8D0BA1AB90F87")
  • Start Date and Expiration Date
  • Certificate ID - Automatically generated

Connection Configuration​

Configure the following fields:

  • Tenant ID: Azure AD Directory ID from app registration
  • Client ID: Application ID from app registration
  • Certificate Thumbprint: SHA-1 thumbprint from uploaded certificate (remove spaces)
  • Private Key: Certificate private key in PEM format
  • Scope: https://graph.microsoft.com/.default for application permissions

Private Key Format​

The private key must be in PEM format with appropriate headers:

-----BEGIN PRIVATE KEY-----
[base64 encoded private key]
-----END PRIVATE KEY-----

Or for RSA keys:

-----BEGIN RSA PRIVATE KEY-----
[base64 encoded RSA private key]
-----END RSA PRIVATE KEY-----
InputDefaultNotesExample
Base URL
string
/ Required
baseUrl
https://graph.microsoft.com
The base URL for the Microsoft Graph API. Depending on your cloud environment, you can choose the correct one [here](https://learn.microsoft.com/en-us/graph/deployments#microsoft-graph-and-graph-explorer-service-root-endpoints).
https://graph.microsoft.com
Private Certificate
text
/ Required
certificate
Your X.509 private certificate.
 
Certificate Thumbprint
string
/ Required
certificateThumbprint
Thumbprint of the certificate.
 
Client ID
string
/ Required
clientId
Client Id of your Azure application.
11111111-2222-3333-4444-555555555555
Microsoft Entra ID Endpoint
string
/ Required
entraIdEndpoint
https://login.microsoftonline.com
The Microsoft Entra ID endpoint for the Microsoft Graph API. You can find this in the Azure portal or [here](https://learn.microsoft.com/en-us/graph/deployments#app-registration-and-token-service-root-endpoints).
https://login.microsoftonline.com
Scopes
string
scopes
https://graph.microsoft.com/.default
Microsoft Graph API Scopes.
 
Tenant
string
/ Required
tenant
The tenant ID or name for the Microsoft Graph API. This is the ID or name of the tenant that you are connecting to.
11111111-2222-3333-4444-555555555555

Microsoft SharePoint OAuth 2.0 (Deprecated)​

Creating an App Registration​

Once you have an instance of Microsoft SharePoint licensed to your account, you will need to create and configure a new "App Registration" within your Azure Active Directory tenant.

  1. Navigate to Microsoft Entra Identity > Applications > App registrations
  2. Select New registration
  3. Configure the basic settings:
    • Name: Provide a descriptive name for the application
    • Supported account types: Select Accounts in any organizational directory (Any Azure AD directory - Multitenant)
    • Redirect URI: Select Web platform and add https://oauth2.prismatic.io/callback
  4. Click Register to create the app registration

Obtaining Application Credentials​

After registration, navigate to the Overview page and note:

  • Application (client) ID - This will be the Client ID
  • Directory (tenant) ID - Required for certain connection types

API Permissions Configuration​

  1. Navigate to API Permissions
  2. Click Add a permission
  3. Select SharePoint for SharePoint-specific operations
  4. Choose Delegated permissions for user-authenticated flows
  5. Select the following permissions:

Essential Scopes:

  • offline_access - Required for refresh tokens (without this, users re-authenticate every hour)

Site Operations:

  • AllSites.Read - Read items in all site collections
  • AllSites.Write - Edit or delete items in all site collections
  • AllSites.Manage - Create, edit and delete items and lists in all site collections
  • AllSites.FullControl - Full control of all site collections

File Operations:

  • MyFiles.Read - Read user files
  • MyFiles.Write - Read and write user files
  • AllSites.Read - Read files in all sites
  • AllSites.Write - Read and write files in all sites

List Operations:

  • AllSites.Write - Required for list item operations
  • AllSites.Manage - For creating and managing lists

User Profile:

  • User.Read.All - Read all users' profiles
  • User.ReadBasic.All - Read all users' basic profiles
  1. Click Add permissions
  2. Important: Click Grant admin consent to activate the permissions

Creating Client Secret​

  1. Navigate to Certificates & Secrets in the app registration
  2. Select the Client secrets tab
  3. Click New client secret
  4. Provide a description and select expiration period
  5. Click Add
  6. Important: Copy the secret Value immediately - it cannot be retrieved later

Connection Configuration​

Configure the following fields:

  • Client ID: Application ID from app registration
  • Client Secret: Secret value created above
  • Authorize URL: Default provided, or tenant-specific URL if not using multitenant
  • Token URL: Default provided, or tenant-specific URL if not using multitenant

Tenant-Specific URLs​

If the app registration is not configured as multitenant, replace the default URLs with tenant-specific versions:

  • Authorize URL: https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize
  • Token URL: https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token
InputDefaultNotesExample
Authorize URL
string
/ Required
authorizeUrl
https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Provide a tenant specific OAuth 2.0 authorize endpoint.
 
Base URL
string
/ Required
baseUrl
https://graph.microsoft.com
The base URL for the Microsoft Graph API. Depending on your cloud environment, you can choose the correct one [here](https://learn.microsoft.com/en-us/graph/deployments#microsoft-graph-and-graph-explorer-service-root-endpoints).
https://graph.microsoft.com
Client ID
string
/ Required
clientId
Client Id of your Azure application.
 
Client Secret
password
/ Required
clientSecret
Client Secret generated under 'Certificates & Secrets' in your Azure application.
 
Scopes
string
/ Required
scopes
Sites.ReadWrite.All Sites.Manage.All offline_access
Space separated OAuth 2.0 permission scopes.
 
Token URL
string
/ Required
tokenUrl
https://login.microsoftonline.com/common/oauth2/v2.0/token
Provide a tenant specific OAuth 2.0 token endpoint.
 

OAuth 2.0 Client Credentials​

App Registration​

First, create an app registration in Microsoft Entra by following the steps in the OAuth connection guide. Then configure the following Microsoft Graph Application permissions for app only authentication:

Site Operations:

  • Sites.Read.All - Read items in all site collections
  • Sites.ReadWrite.All - Read and write items in all site collections
  • Sites.Manage.All - Create, edit, and delete items and lists in all site collections
  • Sites.FullControl.All - Full control of all site collections

File Operations:

  • Files.Read.All - Read files in all site collections
  • Files.ReadWrite.All - Read and write files in all site collections

List Operations:

  • Sites.ReadWrite.All - Required for list operations
  • Sites.Manage.All - For creating and managing lists

User and Group Access:

  • User.Read.All - Read all users' profiles
  • Group.Read.All - Read all groups

Important: Grant admin consent for all configured permissions.

Creating Client Secret​

  1. Navigate to Certificates & Secrets in the app registration
  2. Select the Client secrets tab
  3. Click New client secret
  4. Provide a description and select expiration period
  5. Click Add
  6. Important: Copy the secret Value immediately - it cannot be retrieved later

Connection Configuration​

Configure the following fields:

  • Tenant ID: Azure AD Directory ID from app registration
  • Client ID: Application ID from app registration
  • Client Secret: Secret value created above
  • Scope: https://graph.microsoft.com/.default for application permissions
InputDefaultNotesExample
Base URL
string
/ Required
baseUrl
https://graph.microsoft.com
The base URL for the Microsoft Graph API. Depending on your cloud environment, you can choose the correct one [here](https://learn.microsoft.com/en-us/graph/deployments#microsoft-graph-and-graph-explorer-service-root-endpoints).
https://graph.microsoft.com
Client ID
string
/ Required
clientId
Client Id of your Azure application.
11111111-2222-3333-4444-555555555555
Client Secret
password
/ Required
clientSecret
Client Secret generated under 'Certificates & Secrets' in your Azure application.
11111111-2222-3333-4444-555555555555
Microsoft Entra ID Endpoint
string
/ Required
entraIdEndpoint
https://login.microsoftonline.com
The Microsoft Entra ID endpoint for the Microsoft Graph API. You can find this in the Azure portal or [here](https://learn.microsoft.com/en-us/graph/deployments#app-registration-and-token-service-root-endpoints).
https://login.microsoftonline.com
Scopes
string
scopes
https://graph.microsoft.com/.default
Microsoft Graph API Scopes.
 
Tenant
string
/ Required
tenant
The tenant ID or name for the Microsoft Graph API. This is the ID or name of the tenant that you are connecting to.
11111111-2222-3333-4444-555555555555
Token URL
template
/ Required
Hidden Field
tokenUrl
{{#entraIdEndpoint}}/{{#tenant}}/oauth2/v2.0/token
Provide a tenant specific OAuth 2.0 token endpoint.
 

OAuth 2.0 Authorization Code​

The templated OAuth flow enables user authentication with SharePoint to access data on their behalf.

App Registration​

First, create an app registration in Microsoft Entra by following the steps in the OAuth connection guide.

Permissions​

Configure SharePoint Delegated permissions in the app registration:

  • Select all permissions required for the integration
  • Grant admin consent for the organization
  • Include offline_access scope for refresh token support

Creating Client Secret​

  1. Navigate to Certificates & Secrets in the app registration
  2. Click New client secret
  3. Provide a description and select expiration period
  4. Click Add
  5. Copy the secret Value (not the Secret ID)

Connection Configuration​

Configure the following fields:

  • Client ID: Application ID from app registration
  • Client Secret: Secret value created above

For non-multitenant applications, replace the default URLs:

  • Authorize URL: https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize
  • Token URL: https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token
InputDefaultNotesExample
Authorize URL
template
/ Required
Hidden Field
authorizeUrl
https://{{#tenantUrl}}/oauth2/v2.0/authorize?prompt=consent
The OAuth 2.0 Authorization URL for Microsoft's Graph API.
login.microsoftonline.com/common
Base URL
string
/ Required
baseUrl
https://graph.microsoft.com
The base URL for the Microsoft Graph API. Depending on your cloud environment, you can choose the correct one [here](https://learn.microsoft.com/en-us/graph/deployments#microsoft-graph-and-graph-explorer-service-root-endpoints).
https://graph.microsoft.com
Client ID
string
/ Required
clientId
Client Id of your Azure application.
11111111-2222-3333-4444-555555555555
Client secret value
password
/ Required
clientSecret
Client Secret generated under 'Certificates & Secrets' in your Azure application.
11111111-2222-3333-4444-555555555555
Scopes
string
scopes
Sites.ReadWrite.All Sites.Manage.All offline_access
Microsoft Graph API permission scopes are set on the OAuth application.
 
Tenant URL
string
/ Required
tenantUrl
login.microsoftonline.com/common
The tenant URL for the Microsoft Graph API. This is the URL of the tenant that you are connecting to. You can find this in the Azure portal or [here](https://learn.microsoft.com/en-us/entra/identity-platform/authentication-national-cloud#microsoft-entra-authentication-endpoints).
login.microsoftonline.com/common
Token URL
template
/ Required
Hidden Field
tokenUrl
https://{{#tenantUrl}}/oauth2/v2.0/token
The OAuth 2.0 Token URL for Microsoft's Graph API.
login.microsoftonline.com/common

Triggers​

Drive Changes​

Periodically retrieves changes from a specified drive of a site on a configured schedule. | key: drivePollingTrigger

InputNotesExample
Connection
connection
/ Required
connection
 
 
Drive
string
/ Required
driveId
Provide the unique identifier of a SharePoint drive.
b!WumF-zsD8ku93Y0QqhKM9jVTjPefo6RGrpVCkPpe547Qrf38sox_TYIFuj9sqJhv

Folder Changes​

Periodically retrieves changes from a specified folder of a drive on a configured schedule. | key: folderPollingTrigger

InputNotesExample
Connection
connection
/ Required
connection
 
 
Drive
string
/ Required
driveId
Provide the unique identifier of a SharePoint drive.
b!WumF-zsD8ku93Y0QqhKM9jVTjPefo6RGrpVCkPpe547Qrf38sox_TYIFuj9sqJhv
Folder ID
string
/ Required
folderId
The ID of the folder to monitor for changes.
01Q7VXAXZW7LCB32ODBRCKZNSJIC544FXU

Site Changes​

Periodically retrieves changes from all drives of a site on a configured schedule. | key: pollSiteChanges

InputNotesExample
Connection
connection
/ Required
connection
 
 
Site Id
string
/ Required
siteId
Provide the unique identifier of a SharePoint site.
example.sharepoint.com,c45de8832-a4969-479d-aeb2-7nAh8321,48bf81d7-2d37-40a9-b47b-c1d1960d00f87

Webhook​

Receive and validate webhook requests from Sharepoint for webhooks you configure. | key: webhook

Data Sources​

List Drives from Source​

A picklist of files in a given directory | key: listDrives | type: picklist

InputDefaultNotesExample
Connection
connection
/ Required
connection
 
 
 
Directory
string
dir
/me/drive/root/children
Retrieve the list of Drive resources available for a target User, Group, or Site. Replace {siteId} or {driveId} with relevant ID value. https://learn.microsoft.com/en-us/graph/api/drive-list?view=graph-rest-1.0&tabs=http
Drives: /sites/{siteId}/drives - Folders: /drives/{driveId}/root/children

List Folders from Source​

A picklist of folders in a given directory | key: listFolders | type: picklist

InputDefaultNotesExample
Connection
connection
/ Required
connection
 
 
 
Directory
string
dir
/me/drive/root/children
Retrieve the list of Drive resources available for a target User, Group, or Site. Replace {siteId} or {driveId} with relevant ID value. https://learn.microsoft.com/en-us/graph/api/drive-list?view=graph-rest-1.0&tabs=http
Drives: /sites/{siteId}/drives - Folders: /drives/{driveId}/root/children

List Items in Site List​

A picklist of items in a given site list | key: listItemsInSiteList | type: picklist

InputNotesExample
Connection
connection
/ Required
connection
 
 
List Id
string
/ Required
listId
Provide the unique identifier of a SharePoint site list.
48bf81d7-2d37-40a9-b47b-c1d1960d00f87
Site Id
string
/ Required
siteId
Provide the unique identifier of a SharePoint site.
example.sharepoint.com,c45de8832-a4969-479d-aeb2-7nAh8321,48bf81d7-2d37-40a9-b47b-c1d1960d00f87

List Sites from Sharepoint​

A picklist of Sites | key: listSites | type: picklist

InputNotes
Connection
connection
/ Required
connection
 

List Subscriptions​

A picklist of subscriptions | key: listSubscriptions | type: picklist

InputNotes
Connection
connection
/ Required
connection
 

Actions​

Check Item Exists​

Check if a file or folder exists in a SharePoint drive | key: checkItemExists

InputNotesExample
Connection
connection
/ Required
connection
 
 
Drive
string
/ Required
driveId
Provide the id of the drive to check the item in.
b!WumF-zsD8ku93Y0QqhKM9jVTjPefo6RGrpVCkPpe547Qrf38sox_TYIFuj9sqJhv
Item Path
string
/ Required
itemPath
Provide the path to the file or folder, relative to the drive root.
MyFolder/example.txt
Site Id
string
/ Required
siteId
Provide the id of the site to check the item in.
example.sharepoint.com,c45de8832-a4969-479d-aeb2-7nAh8321,48bf81d7-2d37-40a9-b47b-c1d1960d00f87

{
  "data": {
    "exists": true,
    "message": "Item \"MyFolder\" exists in the specified drive",
    "item": {
      "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(driveItem)/$entity",
      "createdBy": {
        "user": {
          "email": "User@example.com",
          "id": "00000000-0000-0000-0000-000000000001",
          "displayName": "Example User"
        }
      },
      "createdDateTime": "2025-06-11T22:08:54Z",
      "eTag": "\"{DRIVE-ITEM-ETAG},2\"",
      "id": "ITEM-ID-001",
      "lastModifiedBy": {
        "user": {
          "email": "User@example.com",
          "id": "00000000-0000-0000-0000-000000000001",
          "displayName": "Example User"
        }
      },
      "lastModifiedDateTime": "2025-06-12T23:48:54Z",
      "name": "MyFolder",
      "parentReference": {
        "driveType": "documentLibrary",
        "driveId": "DRIVE-ID-001",
        "id": "ITEM-ID-002",
        "name": "Shared Documents",
        "path": "/drives/DRIVE-ID-001/root:",
        "siteId": "SITE-ID-001"
      },
      "webUrl": "https://example.sharepoint.com/sites/ExampleSite/Shared%20Documents/MyFolder",
      "cTag": "\"c:{DRIVE-ITEM-CTAG},0\"",
      "fileSystemInfo": {
        "createdDateTime": "2025-06-11T22:08:54Z",
        "lastModifiedDateTime": "2025-06-12T23:48:54Z"
      },
      "folder": {
        "childCount": 2
      },
      "shared": {
        "scope": "users"
      },
      "size": 46758
    }
  }
}

Create a Folder​

Create a Folder in a Drive | key: createFolder

InputNotesExample
Connection
connection
/ Required
connection
 
 
Drive
string
/ Required
driveId
Provide the id of the drive to create the folder in.
b!WumF-zsD8ku93Y0QqhKM9jVTjPefo6RGrpVCkPpe547Qrf38sox_TYIFuj9sqJhv
Folder Name
string
/ Required
folderName
Provide the name of the new folder.
MyFolder
Parent Item Id
string
/ Required
parentItemId
Provide the id of the parent element to create the folder in.
root
Site Id
string
/ Required
siteId
Provide the id of the site to create the folder in.
example.sharepoint.com,c45de8832-a4969-479d-aeb2-7nAh8321,48bf81d7-2d37-40a9-b47b-c1d1960d00f87

{
  "data": {
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#sites('example.sharepoint.com%2Cexample-site-id%2Cexample-web-id')/drives('b%21exampleDriveId')/items('root')/children/$entity",
    "@odata.etag": "\"{EXAMPLE-ETAG-ID},1\"",
    "createdDateTime": "2025-06-12T22:28:24Z",
    "eTag": "\"{EXAMPLE-ETAG-ID},1\"",
    "id": "exampleItemId123456",
    "lastModifiedDateTime": "2025-06-12T22:28:24Z",
    "name": "NewFolder",
    "size": 0,
    "webUrl": "https://example.sharepoint.com/sites/ExampleSite/Shared%20Documents/NewFolder",
    "cTag": "\"c:{EXAMPLE-ETAG-ID},0\"",
    "commentSettings": {
      "commentingDisabled": {
        "isDisabled": false
      }
    },
    "createdBy": {
      "application": {
        "displayName": "ExampleApp",
        "id": "example-app-id-1234"
      },
      "user": {
        "displayName": "Example User",
        "email": "example.user@example.com",
        "id": "example-user-id-1234"
      }
    },
    "lastModifiedBy": {
      "application": {
        "displayName": "ExampleApp",
        "id": "example-app-id-1234"
      },
      "user": {
        "displayName": "Example User",
        "email": "example.user@example.com",
        "id": "example-user-id-1234"
      }
    },
    "parentReference": {
      "driveId": "b!exampleDriveId",
      "driveType": "documentLibrary",
      "id": "exampleParentItemId123456",
      "path": "/drives/b!exampleDriveId/root:",
      "sharepointIds": {
        "listId": "example-list-id-1234",
        "listItemUniqueId": "example-list-item-id-1234",
        "siteId": "example-site-id-1234",
        "siteUrl": "https://example.sharepoint.com/sites/ExampleSite",
        "tenantId": "example-tenant-id-1234",
        "webId": "example-web-id-1234"
      }
    },
    "fileSystemInfo": {
      "createdDateTime": "2025-06-12T22:28:24Z",
      "lastModifiedDateTime": "2025-06-12T22:28:24Z"
    },
    "folder": {
      "childCount": 0
    },
    "shared": {
      "scope": "unknown"
    }
  }
}

Create a Subscription​

Create a Subscription to notify you of changes to a resource | key: createSubscription

InputDefaultNotesExample
Allow Duplicates
boolean
allowDuplicates
false
Enable to allow more than one subscription per endpoint
 
Change Type
string
/ Required
changeType
updated
The type of changes that should generate notifications for this subscription. OneDrive only supports updated.
updated
Client State
string
clientState
An optional string value that is passed back in the notification message for this subscription.
client-specific string
Connection
connection
/ Required
connection
 
 
 
Expiration Date Time
string
/ Required
expirationDateTime
The date and time when the subscription will expire if not updated or renewed.
2018-01-01T11:23:00.000Z
Notification URL
string
/ Required
notificationUrl
The URL that notifications should be delivered to, if required for the specified notificationType.
https://contoso.azurewebsites.net/api/webhook-receiver
Resource
string
/ Required
resource
The relative path of the subscription within the drive. Read-only.
/me/drive/root

{
  "data": {
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#subscriptions/$entity",
    "id": "38031b7d-16b1-448a-8e68-68b8aec62315",
    "resource": "/me/drive/root",
    "applicationId": "0fed8223-8c47-4c71-ba78-92c6f9448725",
    "changeType": "updated",
    "clientState": "client-specific string",
    "notificationUrl": "https://hooks.example.com/trigger/SW5z",
    "notificationQueryOptions": null,
    "lifecycleNotificationUrl": null,
    "expirationDateTime": "2023-07-01T11:23:00Z",
    "creatorId": "6219df3c-04d4-4b39-b2a4-ad162a5dcb8f",
    "includeResourceData": null,
    "latestSupportedTlsVersion": "v1_2",
    "encryptionCertificate": null,
    "encryptionCertificateId": null,
    "notificationUrlAppId": null
  }
}

Create Item in Site List​

Create a new item inside the given site list | key: createItemInSite

InputNotesExample
Connection
connection
/ Required
connection
 
 
Fields
string
/ Required
Key Value List
fields
For each item, provide a key value pair to be added to the new drive item's properties.
 
List Id
string
/ Required
listId
Provide the unique identifier of a SharePoint site list.
48bf81d7-2d37-40a9-b47b-c1d1960d00f87
Site Id
string
/ Required
siteId
Provide the unique identifier of a SharePoint site.
example.sharepoint.com,c45de8832-a4969-479d-aeb2-7nAh8321,48bf81d7-2d37-40a9-b47b-c1d1960d00f87

Create Site List Subscription​

Create a Site List subscription for Microsoft SharePoint | key: createSiteListSubscription

InputDefaultNotesExample
Allow Duplicates
boolean
allowDuplicates
false
Enable to allow more than one webhook per endpoint
 
Connection
connection
/ Required
connection
 
 
 
Expiration Date/Time
string
expirationDateTime
Expiration date/time for subscription. If unspecified the default will be the current date/time plus 29 days (close to the maximum permitted by the Graph API).
 
List Id
string
/ Required
listId
Provide the unique identifier of a SharePoint site list.
48bf81d7-2d37-40a9-b47b-c1d1960d00f87
Notification URL
string
/ Required
notificationUrl
URL to send events of this Subscription to
 
Site Id
string
/ Required
siteId
Provide the unique identifier of a SharePoint site.
example.sharepoint.com,c45de8832-a4969-479d-aeb2-7nAh8321,48bf81d7-2d37-40a9-b47b-c1d1960d00f87

{
  "data": {
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#subscriptions/$entity",
    "id": "e9d5b726-4478-4412-bfba-268530484566",
    "resource": "sites/example.sharepoint.com,17cd4ada-1a76-420e-a7ec-4adaa3327c86,87742bc7-2d2f-404c-8255-d3d9fa9a6561/lists/3a3c0f6a-86da-4567-94d4-3b939da63200",
    "applicationId": "e76615c0-13e3-4cd2-8235-a2d628ad13de",
    "changeType": "updated",
    "clientState": null,
    "notificationUrl": "https://example.com/webhook/",
    "notificationQueryOptions": null,
    "lifecycleNotificationUrl": null,
    "expirationDateTime": "2022-11-22T23:32:10.231Z",
    "creatorId": "c8edbeda-c453-446c-91ce-c6d5c7310a6c",
    "includeResourceData": null,
    "latestSupportedTlsVersion": "v1_2",
    "encryptionCertificate": null,
    "encryptionCertificateId": null,
    "notificationUrlAppId": null
  }
}

Delete a Subscription​

Delete a Subscription by ID | key: deleteSubscription

InputNotesExample
Connection
connection
/ Required
connection
 
 
Subscription Id
string
/ Required
subscriptionId
The Id the subscription to delete
48bf81d7-2d37-40a9-b47b-c1d1960d00f87

{
  "data": ""
}

Delete All Instance Subscriptions​

Delete all subscriptions pointed at this instance | key: deleteAllInstanceSubscriptions

InputNotes
Connection
connection
/ Required
connection
 

{
  "data": {
    "subscriptionsRemoved": [
      "26ebd1e9-c54a-4bbe-9583-fc05974952a4",
      "b9b27172-ee2e-4248-86df-fc98cb71d914"
    ]
  }
}

Download File​

Download a file from the specified drive | key: downloadFile

InputNotesExample
Connection
connection
/ Required
connection
 
 
Drive
string
/ Required
driveId
Provide the unique identifier of a SharePoint drive.
b!WumF-zsD8ku93Y0QqhKM9jVTjPefo6RGrpVCkPpe547Qrf38sox_TYIFuj9sqJhv
Item Id
string
/ Required
itemId
Provide the unique identifier of a SharePoint item Id.
01Q7VXROAW7LCB32ODBRCKZNSJIC544XAQ

Get Current User​

Get the information and metadata of the user that is currently logged in | key: getCurrentUser

InputNotes
Connection
connection
/ Required
connection
 

{
  "data": {
    "businessPhones": [
      "+1 555 555 5555"
    ],
    "displayName": "exampleUser",
    "givenName": "exampleUser",
    "jobTitle": "Retail Manager",
    "mail": "someoneV@example.onmicrosoft.com",
    "mobilePhone": "+1 555 555 5555",
    "officeLocation": "example",
    "preferredLanguage": "en-US",
    "surname": "Example",
    "id": "3693-4789-a1c3-f4de565f"
  }
}

Get Drive​

Returns the information and metadata of a SharePoint drive | key: getDrive

InputNotesExample
Connection
connection
/ Required
connection
 
 
Drive
string
/ Required
driveId
Provide the unique identifier of a SharePoint drive.
b!WumF-zsD8ku93Y0QqhKM9jVTjPefo6RGrpVCkPpe547Qrf38sox_TYIFuj9sqJhv

Get File​

Get a file from a Drive | key: getFile

InputNotesExample
Connection
connection
/ Required
connection
 
 
Drive
string
/ Required
driveId
Provide the unique identifier of a SharePoint drive.
b!WumF-zsD8ku93Y0QqhKM9jVTjPefo6RGrpVCkPpe547Qrf38sox_TYIFuj9sqJhv
Item Id
string
/ Required
itemId
Provide the unique identifier of a SharePoint item Id.
01Q7VXROAW7LCB32ODBRCKZNSJIC544XAQ

Get Item from Site List​

Returns the information and metadata of the given item | key: getItemInSite

InputNotesExample
Connection
connection
/ Required
connection
 
 
Item Id
string
/ Required
itemId
Provide the unique identifier of a SharePoint item Id.
01Q7VXROAW7LCB32ODBRCKZNSJIC544XAQ
List Id
string
/ Required
listId
Provide the unique identifier of a SharePoint site list.
48bf81d7-2d37-40a9-b47b-c1d1960d00f87
Opt In Fields
string
optInFields
Provide a comma separated list of fields to overwrite the default result set.
name, description, id
Site Id
string
/ Required
siteId
Provide the unique identifier of a SharePoint site.
example.sharepoint.com,c45de8832-a4969-479d-aeb2-7nAh8321,48bf81d7-2d37-40a9-b47b-c1d1960d00f87

Get Root Site​

Returns the information and metadata of the root SharePoint site in your tenant | key: getRootSite

InputNotes
Connection
connection
/ Required
connection
 

{
  "data": {
    "description": "Example description",
    "id": "example.sharepoint.com,c45e332-a998-479d-aeb2-2a",
    "name": "Example SharePoint Site",
    "webUrl": "https://example.sharepoint.com",
    "displayName": "Communication Site",
    "siteCollection": {
      "hostname": "https://example.sharepoint.com"
    }
  }
}

Get Site​

Returns the information and metadata of the given SharePoint site | key: getSite

InputNotesExample
Connection
connection
/ Required
connection
 
 
Site Id
string
/ Required
siteId
Provide the unique identifier of a SharePoint site.
example.sharepoint.com,c45de8832-a4969-479d-aeb2-7nAh8321,48bf81d7-2d37-40a9-b47b-c1d1960d00f87

{
  "data": {
    "description": "Example description",
    "id": "example.sharepoint.com,c45e332-a998-479d-aeb2-2a",
    "name": "Example SharePoint Site",
    "webUrl": "https://example.sharepoint.com",
    "displayName": "Communication Site",
    "siteCollection": {
      "hostname": "https://example.sharepoint.com"
    }
  }
}

Get Site List​

Returns the information and metadata of an existing site list | key: getList

InputNotesExample
Connection
connection
/ Required
connection
 
 
List Id
string
/ Required
listId
Provide the unique identifier of a SharePoint site list.
48bf81d7-2d37-40a9-b47b-c1d1960d00f87
Site Id
string
/ Required
siteId
Provide the unique identifier of a SharePoint site.
example.sharepoint.com,c45de8832-a4969-479d-aeb2-7nAh8321,48bf81d7-2d37-40a9-b47b-c1d1960d00f87

List Changes​

Track changes in a driveItem and its children over time. | key: listChanges

InputDefaultNotesExample
$expand Parameter
string
$expand
Retrieves related resources. https://learn.microsoft.com/en-us/graph/query-parameters?tabs=http#expand-parameter
members
$select Parameter
string
$select
Filters properties (columns). https://learn.microsoft.com/en-us/graph/query-parameters?tabs=http#select-parameter
givenName,surname
$top Parameter
string
$top
Sets the page size of results. https://learn.microsoft.com/en-us/graph/query-parameters?tabs=http#top-parameter
5
Connection
connection
/ Required
connection
 
 
 
URL to fetch for delta
string
/ Required
deltaURL
/drives/{drive-id}/root/delta
The URL to track changes in a driveItem and its children over time. You can also paste here the @odata.nextLink or @odata.deltaLink from a previous response to resume tracking changes.
/drives/{drive-id}/root/delta
Fetch All
boolean
fetchAll
false
Set to true to retrieve all results.
 

List Drives​

List all drives within any given SharePoint site | key: listDrives

InputDefaultNotesExample
Connection
connection
/ Required
connection
 
 
 
Fetch All
boolean
fetchAll
false
Set to true to retrieve all results.
 
Page Limit
string
pageLimit
Enter a number amount for the page size.
100
Page Token
string
pageToken
Enter the token for the desired page.
X%2744537079ghv
Site Id
string
/ Required
siteId
Provide the unique identifier of a SharePoint site.
example.sharepoint.com,c45de8832-a4969-479d-aeb2-7nAh8321,48bf81d7-2d37-40a9-b47b-c1d1960d00f87

{
  "data": {
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#drives",
    "value": [
      {
        "createdDateTime": "2023-05-14T05:14:52Z",
        "description": "",
        "id": "b!o2UaIfdNxk-5091VjGz1sDVso2efo6RGrpVCkPpe547Qrf38sox_TYIFuj9QrJhv",
        "lastModifiedDateTime": "2023-05-14T05:14:52Z",
        "name": "Documents",
        "webUrl": "https://example.sharepoint.com/Shared%20Documents",
        "driveType": "documentLibrary",
        "createdBy": {
          "user": {
            "displayName": "System Account"
          }
        },
        "owner": {
          "group": {
            "id": "9705118a-6ce1-4fa3-adba-09f94b69d568",
            "displayName": "9705118a-6ce1-4fa3-acda-09f94b69d446"
          }
        },
        "quota": {
          "deleted": 0,
          "remaining": 27487789251101,
          "state": "normal",
          "total": 27487790694400,
          "used": 1443299
        }
      }
    ]
  }
}

List Files in Drive​

List all the files from a Drive | key: getFilesFromDriveWithPagination

InputDefaultNotesExample
Connection
connection
/ Required
connection
 
 
 
Drive
string
/ Required
driveId
Provide the unique identifier of a SharePoint drive.
b!WumF-zsD8ku93Y0QqhKM9jVTjPefo6RGrpVCkPpe547Qrf38sox_TYIFuj9sqJhv
Fetch All
boolean
fetchAll
false
Set to true to retrieve all results.
 
Page Limit
string
pageLimit
Enter a number amount for the page size.
100
Page Token
string
pageToken
Enter the token for the desired page.
X%2744537079ghv
Recursive
boolean
recursive
false
If true, it will also return all the files from the subfolders.
 

List Files in Drive (Deprecated)​

List all the files from a Drive. This version of the action is being deprecated. Please replace action with List Files In Drive. | key: getFilesFromDrive

InputNotesExample
Connection
connection
/ Required
connection
 
 
Drive
string
/ Required
driveId
Provide the unique identifier of a SharePoint drive.
b!WumF-zsD8ku93Y0QqhKM9jVTjPefo6RGrpVCkPpe547Qrf38sox_TYIFuj9sqJhv

List Folder Files in Drive​

List all the files inside of a folder from a Drive | key: getFilesFromDriveFolderWithPagination

InputDefaultNotesExample
Connection
connection
/ Required
connection
 
 
 
Drive
string
/ Required
driveId
Provide the unique identifier of a SharePoint drive.
b!WumF-zsD8ku93Y0QqhKM9jVTjPefo6RGrpVCkPpe547Qrf38sox_TYIFuj9sqJhv
Fetch All
boolean
fetchAll
false
Set to true to retrieve all results.
 
Folder ID
string
folderId
Provide the unique identifier of a Sharepoint folder Id.
01Q7VXAXZW7LCB32ODBRCKZNSJIC544FXU
Page Limit
string
pageLimit
Enter a number amount for the page size.
100
Page Token
string
pageToken
Enter the token for the desired page.
X%2744537079ghv

List Folder Files in Drive (Deprecated)​

List all the files inside of a folder from a Drive. This version of the action is being deprecated. Please replace action with List Folder Files In Drive. | key: getFilesFromDriveFolder

InputNotesExample
Connection
connection
/ Required
connection
 
 
Drive
string
/ Required
driveId
Provide the unique identifier of a SharePoint drive.
b!WumF-zsD8ku93Y0QqhKM9jVTjPefo6RGrpVCkPpe547Qrf38sox_TYIFuj9sqJhv
Folder ID
string
folderId
Provide the unique identifier of a Sharepoint folder Id.
01Q7VXAXZW7LCB32ODBRCKZNSJIC544FXU

List Followed Sites​

List all Followed Sites | key: listFollowedSites

InputDefaultNotesExample
Connection
connection
/ Required
connection
 
 
 
Fetch All
boolean
fetchAll
false
Set to true to retrieve all results.
 
Page Limit
string
pageLimit
Enter a number amount for the page size.
100
Page Token
string
pageToken
Enter the token for the desired page.
X%2744537079ghv

{
  "data": {
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#sites",
    "value": [
      {
        "displayName": "Example",
        "id": "example.sharepoint.com,6c44888f-5883-4ef0-c542-d21a802cfea6,ed2d5d06-e192-4047-afa6-a5d7f25b3418",
        "sharepointIds": {
          "siteId": "6c44888f-5883-4ef0-c542-d21a802cfea6",
          "webId": "ed2d5d06-e192-4047-afa6-a5d7f25b3418"
        },
        "siteCollection": {
          "hostname": "example.sharepoint.com"
        },
        "webUrl": "https://example.sharepoint.com/sites/Example"
      }
    ]
  }
}

List Items​

List Items in a Folder | key: listItems

InputNotesExample
Connection
connection
/ Required
connection
 
 
Drive
string
/ Required
driveId
Provide the id of the drive to list the items in.
b!WumF-zsD8ku93Y0QqhKM9jVTjPefo6RGrpVCkPpe547Qrf38sox_TYIFuj9sqJhv
Folder ID
string
/ Required
folderId
Provide the id of the folder to list the items in.
01Q7VXAXZW7LCB32ODBRCKZNSJIC544FXU

{
  "data": {
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(driveItem)",
    "value": [
      {
        "@microsoft.graph.downloadUrl": "https://example.sharepoint.com/sites/ExampleSite/_layouts/15/download.aspx?UniqueId=example-unique-id&Translate=false&tempauth=example-auth-token&ApiVersion=2.0",
        "createdBy": {
          "user": {
            "email": "example.user@example.onmicrosoft.com",
            "id": "00000000-0000-0000-0000-000000000000",
            "displayName": "Example User"
          }
        },
        "createdDateTime": "2025-06-12T23:24:20Z",
        "eTag": "\"{EXAMPLE-ID},5\"",
        "id": "EXAMPLE-FILE-ID-12345",
        "lastModifiedBy": {
          "user": {
            "email": "example.user@example.onmicrosoft.com",
            "id": "00000000-0000-0000-0000-000000000000",
            "displayName": "Example User"
          }
        },
        "lastModifiedDateTime": "2025-06-12T23:24:49Z",
        "name": "example-file.docx",
        "parentReference": {
          "driveType": "documentLibrary",
          "driveId": "b!ExampleDriveId123456789",
          "id": "EXAMPLE-FOLDER-ID-12345",
          "name": "ExampleFolder",
          "path": "/drives/b!ExampleDriveId123456789/root:/ExampleFolder",
          "siteId": "00000000-0000-0000-0000-000000000000"
        },
        "webUrl": "https://example.sharepoint.com/sites/ExampleSite/_layouts/15/Doc.aspx?sourcedoc=%7BEXAMPLE-ID%7D&file=example-file.docx&action=default&mobileredirect=true",
        "cTag": "\"c:{EXAMPLE-ID},7\"",
        "file": {
          "hashes": {
            "quickXorHash": "ExampleHashBase64=="
          },
          "mimeType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
        },
        "fileSystemInfo": {
          "createdDateTime": "2025-06-12T23:24:20Z",
          "lastModifiedDateTime": "2025-06-12T23:24:49Z"
        },
        "shared": {
          "scope": "users"
        },
        "size": 19802
      }
    ]
  }
}

List Items in Site List​

Return all items inside the given site list | key: getListItemsInSite

InputNotesExample
Connection
connection
/ Required
connection
 
 
List Id
string
/ Required
listId
Provide the unique identifier of a SharePoint site list.
48bf81d7-2d37-40a9-b47b-c1d1960d00f87
Opt In Fields
string
optInFields
Provide a comma separated list of fields to overwrite the default result set.
name, description, id
Page Limit
string
pageLimit
Enter a number amount for the page size.
100
Page Token
string
pageToken
Enter the token for the desired page.
X%2744537079ghv
Site Id
string
/ Required
siteId
Provide the unique identifier of a SharePoint site.
example.sharepoint.com,c45de8832-a4969-479d-aeb2-7nAh8321,48bf81d7-2d37-40a9-b47b-c1d1960d00f87

List Shared Documents​

Lists documents shared with the user. | key: listSharedDocuments

InputNotes
Connection
connection
/ Required
connection
 

List Site Lists​

List all Site Lists | key: listSiteLists

InputDefaultNotesExample
Connection
connection
/ Required
connection
 
 
 
Fetch All
boolean
fetchAll
false
Set to true to retrieve all results.
 
Site Id
string
/ Required
siteId
Provide the unique identifier of a SharePoint site.
example.sharepoint.com,c45de8832-a4969-479d-aeb2-7nAh8321,48bf81d7-2d37-40a9-b47b-c1d1960d00f87

List Sites​

List all SharePoint sites | key: listSites

InputDefaultNotesExample
Connection
connection
/ Required
connection
 
 
 
Fetch All
boolean
fetchAll
false
Set to true to retrieve all results.
 
Page Limit
string
pageLimit
Enter a number amount for the page size.
100
Page Token
string
pageToken
Enter the token for the desired page.
X%2744537079ghv

{
  "data": {
    "value": [
      {
        "description": "Example description",
        "id": "example.sharepoint.com,c45e332-a998-479d-aeb2-2a",
        "name": "Example SharePoint Site",
        "webUrl": "https://example.sharepoint.com",
        "displayName": "Communication Site",
        "siteCollection": {
          "hostname": "https://example.sharepoint.com"
        }
      }
    ]
  }
}

List Subscriptions​

List all available Subscriptions | key: listSubscriptions

InputDefaultNotes
Connection
connection
/ Required
connection
 
 
Show Instance Subscriptions
boolean
showInstanceSubscriptions
true
Show only subscriptions for this Instance's Subscriptions

{
  "data": {
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#subscriptions",
    "value": [
      {
        "id": "38031b7d-16b1-448a-8e68-68b8aec6df45",
        "resource": "/me/drive/root",
        "applicationId": "0fed8223-8c47-4c71-ba78-92c6f9441235",
        "changeType": "updated",
        "clientState": null,
        "notificationUrl": "https://hooks.example.com/trigger/SW5",
        "notificationQueryOptions": null,
        "lifecycleNotificationUrl": null,
        "expirationDateTime": "2023-07-01T11:23:00Z",
        "creatorId": "62162f3c-04d4-4b39-b2a4-ad891a5dcb8f",
        "includeResourceData": null,
        "latestSupportedTlsVersion": "v1_2",
        "encryptionCertificate": null,
        "encryptionCertificateId": null,
        "notificationUrlAppId": null
      }
    ]
  }
}

Move a File​

Move a File in a Drive | key: moveFile

InputNotesExample
Connection
connection
/ Required
connection
 
 
Drive
string
/ Required
driveId
Provide the id of the drive to move the file in.
b!WumF-zsD8ku93Y0QqhKM9jVTjPefo6RGrpVCkPpe547Qrf38sox_TYIFuj9sqJhv
Item Id
string
/ Required
itemId
Provide the id of the file to move.
01Q7VXROAW7LCB32ODBRCKZNSJIC544XAQ
Destination Parent Id
string
/ Required
parentItemId
Provide the Id of the destination parent element to move file to.
root

{
  "data": {
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#drives('drive-id')/items/$entity",
    "@microsoft.graph.downloadUrl": "https://example.sharepoint.com/sites/ExampleSite/_layouts/15/download.aspx?UniqueId=example-unique-id&Translate=false&tempauth=example-tempauth-token&ApiVersion=2.0",
    "createdDateTime": "2025-06-12T23:24:20Z",
    "eTag": "\"{EXAMPLE-ETAG},7\"",
    "id": "example-file-id",
    "lastModifiedDateTime": "2025-06-12T23:24:49Z",
    "name": "example.docx",
    "webUrl": "https://example.sharepoint.com/sites/ExampleSite/_layouts/15/Doc.aspx?sourcedoc=%7BEXAMPLE-ID%7D&file=example.docx&action=default&mobileredirect=true",
    "cTag": "\"c:{EXAMPLE-CTAG},8\"",
    "size": 19802,
    "createdBy": {
      "user": {
        "email": "user@example.com",
        "id": "00000000-0000-0000-0000-000000000000",
        "displayName": "Example User"
      }
    },
    "lastModifiedBy": {
      "user": {
        "email": "user@example.com",
        "id": "00000000-0000-0000-0000-000000000000",
        "displayName": "Example User"
      }
    },
    "parentReference": {
      "driveType": "documentLibrary",
      "driveId": "example-drive-id",
      "id": "example-parent-id",
      "name": "Shared Documents",
      "path": "/drives/example-drive-id/root:",
      "siteId": "00000000-0000-0000-0000-000000000000"
    },
    "file": {
      "mimeType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
      "hashes": {
        "quickXorHash": "exampleBase64Hash=="
      }
    },
    "fileSystemInfo": {
      "createdDateTime": "2025-06-12T23:24:20Z",
      "lastModifiedDateTime": "2025-06-12T23:24:49Z"
    },
    "shared": {
      "scope": "users"
    }
  }
}

Raw Request​

Send raw HTTP request to Microsoft Sharepoint | key: rawRequest

InputDefaultNotesExample
Connection
connection
/ Required
connection
 
 
 
Data
string
data
The HTTP body payload to send to the URL.
{"exampleKey": "Example Data"}
File Data
string
Key Value List
fileData
File Data to be sent as a multipart form upload.
[{key: "example.txt", value: "My File Contents"}]
File Data File Names
string
Key Value List
fileDataFileNames
File names to apply to the file data inputs. Keys must match the file data keys above.
 
Form Data
string
Key Value List
formData
The Form Data to be sent as a multipart form upload.
[{"key": "Example Key", "value": new Buffer("Hello World")}]
Header
string
Key Value List
headers
A list of headers to send with the request.
User-Agent: curl/7.64.1
Max Retry Count
string
maxRetries
0
The maximum number of retries to attempt. Specify 0 for no retries.
 
Method
string
/ Required
method
The HTTP method to use.
 
Query Parameter
string
Key Value List
queryParams
A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
 
Response Type
string
/ Required
responseType
json
The type of data you expect in the response. You can request json, text, or binary data.
 
Retry On All Errors
boolean
retryAllErrors
false
If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.
 
Retry Delay (ms)
string
retryDelayMS
0
The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.
 
Timeout
string
timeout
The maximum time that a client will await a response to its request
2000
URL
string
/ Required
url
Input the path only (/me/followedSites), The base URL is already included (https://graph.microsoft.com/v1.0). For example, to connect to https://graph.microsoft.com/v1.0/me/followedSites, only /me/followedSites is entered in this field.
/me/followedSites
Use Exponential Backoff
boolean
useExponentialBackoff
false
Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.
 

Rename a Folder​

Rename a Folder in a Drive | key: renameFolder

InputNotesExample
Connection
connection
/ Required
connection
 
 
Drive
string
/ Required
driveId
Provide the id of the drive to rename the folder in.
b!WumF-zsD8ku93Y0QqhKM9jVTjPefo6RGrpVCkPpe547Qrf38sox_TYIFuj9sqJhv
Folder ID
string
/ Required
folderId
Provide the id of the folder to rename.
01Q7VXAXZW7LCB32ODBRCKZNSJIC544FXU
Folder Name
string
/ Required
folderName
Provide the new name of the folder.
MyFolder
Site Id
string
/ Required
siteId
Provide the id of the site to rename the folder in.
example.sharepoint.com,c45de8832-a4969-479d-aeb2-7nAh8321,48bf81d7-2d37-40a9-b47b-c1d1960d00f87

{
  "data": {
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#sites('example.sharepoint.com%2Cexample-site-id%2Cexample-web-id')/drives('b%21exampleDriveId')/items('root')/children/$entity",
    "@odata.etag": "\"{EXAMPLE-ETAG-ID},1\"",
    "createdDateTime": "2025-06-12T22:28:24Z",
    "eTag": "\"{EXAMPLE-ETAG-ID},1\"",
    "id": "exampleItemId123456",
    "lastModifiedDateTime": "2025-06-12T22:28:24Z",
    "name": "NewFolder",
    "size": 0,
    "webUrl": "https://example.sharepoint.com/sites/ExampleSite/Shared%20Documents/NewFolder",
    "cTag": "\"c:{EXAMPLE-ETAG-ID},0\"",
    "commentSettings": {
      "commentingDisabled": {
        "isDisabled": false
      }
    },
    "createdBy": {
      "application": {
        "displayName": "ExampleApp",
        "id": "example-app-id-1234"
      },
      "user": {
        "displayName": "Example User",
        "email": "example.user@example.com",
        "id": "example-user-id-1234"
      }
    },
    "lastModifiedBy": {
      "application": {
        "displayName": "ExampleApp",
        "id": "example-app-id-1234"
      },
      "user": {
        "displayName": "Example User",
        "email": "example.user@example.com",
        "id": "example-user-id-1234"
      }
    },
    "parentReference": {
      "driveId": "b!exampleDriveId",
      "driveType": "documentLibrary",
      "id": "exampleParentItemId123456",
      "path": "/drives/b!exampleDriveId/root:",
      "sharepointIds": {
        "listId": "example-list-id-1234",
        "listItemUniqueId": "example-list-item-id-1234",
        "siteId": "example-site-id-1234",
        "siteUrl": "https://example.sharepoint.com/sites/ExampleSite",
        "tenantId": "example-tenant-id-1234",
        "webId": "example-web-id-1234"
      }
    },
    "fileSystemInfo": {
      "createdDateTime": "2025-06-12T22:28:24Z",
      "lastModifiedDateTime": "2025-06-12T22:28:24Z"
    },
    "folder": {
      "childCount": 0
    },
    "shared": {
      "scope": "unknown"
    }
  }
}

Search Items​

Search for items across all drives in a SharePoint site | key: searchItems

InputNotesExample
Connection
connection
/ Required
connection
 
 
Query
string
/ Required
query
Provide the query to search for items by name.
Invoices
Site Id
string
/ Required
siteId
Provide the id of the site to search the items in.
example.sharepoint.com,c45de8832-a4969-479d-aeb2-7nAh8321,48bf81d7-2d37-40a9-b47b-c1d1960d00f87

{
  "data": {
    "Documents": [
      {
        "createdDateTime": "2025-06-11T22:08:54Z",
        "id": "0125EXAMPLERANDOMFOLDERID1234567890",
        "lastModifiedDateTime": "2025-06-12T23:48:54Z",
        "name": "renamedFolder",
        "webUrl": "https://example.sharepoint.com/sites/ExampleSite/Shared%20Documents/renamedFolder",
        "size": 0,
        "createdBy": {
          "user": {
            "email": "user@example.com",
            "displayName": "Example User"
          }
        },
        "lastModifiedBy": {
          "user": {
            "email": "user@example.com",
            "displayName": "Example User"
          }
        },
        "parentReference": {
          "driveType": "documentLibrary",
          "driveId": "b!ExampleDriveIDRandomString12345",
          "id": "0125EXAMPLEPARENTID0987654321",
          "siteId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
        },
        "fileSystemInfo": {
          "createdDateTime": "2025-06-11T22:08:54Z",
          "lastModifiedDateTime": "2025-06-12T23:48:54Z"
        },
        "folder": {
          "childCount": 0
        },
        "searchResult": {}
      }
    ]
  }
}

Update File​

Update a file to the specified drive | key: updateFile

InputNotesExample
Connection
connection
/ Required
connection
 
 
Drive
string
/ Required
driveId
Provide the unique identifier of a SharePoint drive.
b!WumF-zsD8ku93Y0QqhKM9jVTjPefo6RGrpVCkPpe547Qrf38sox_TYIFuj9sqJhv
File Data
data
/ Required
fileData
Provide data to be uploaded to your desired SharePoint drive.
These are my file contents.
Item Id
string
/ Required
itemId
Provide the unique identifier of a SharePoint item Id.
01Q7VXROAW7LCB32ODBRCKZNSJIC544XAQ

Update Site List Subscription Expiration​

Update existing Site List subscription expiration for Microsoft SharePoint | key: updateSiteListSubscriptionExpiration

InputNotes
Connection
connection
/ Required
connection
 
Expiration Date/Time
string
expirationDateTime
Expiration date/time for subscription. If unspecified the default will be the current date/time plus 29 days (close to the maximum permitted by the Graph API).
Subscription ID
string
/ Required
subscriptionId
Subscription ID to manage

Subscriptions have an expiration date/time provided upon creation. This can also be modified with the update API. This action will default to adding 29 days (close to the maximum value for SharePoint resources) to the current date/time unless a value is specified. This is useful for "touching" the subscription to ensure its expiration is extended.

{
  "data": {
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#subscriptions/$entity",
    "id": "e9d5b726-4478-4412-bfba-268530484566",
    "resource": "sites/example.sharepoint.com,17cd4ada-1a76-420e-a7ec-4adaa3327c86,87742bc7-2d2f-404c-8255-d3d9fa9a6561/lists/3a3c0f6a-86da-4567-94d4-3b939da63200",
    "applicationId": "e76615c0-13e3-4cd2-8235-a2d628ad13de",
    "changeType": "updated",
    "clientState": null,
    "notificationUrl": "https://example.com/webhook/",
    "notificationQueryOptions": null,
    "lifecycleNotificationUrl": null,
    "expirationDateTime": "2022-11-22T23:32:10.231Z",
    "creatorId": "c8edbeda-c453-446c-91ce-c6d5c7310a6c",
    "includeResourceData": null,
    "latestSupportedTlsVersion": "v1_2",
    "encryptionCertificate": null,
    "encryptionCertificateId": null,
    "notificationUrlAppId": null
  }
}

Upload File​

Upload a file to the specified drive or folder's drive | key: uploadFile

InputNotesExample
Connection
connection
/ Required
connection
 
 
Drive
string
/ Required
driveId
Provide the unique identifier of a SharePoint drive.
b!WumF-zsD8ku93Y0QqhKM9jVTjPefo6RGrpVCkPpe547Qrf38sox_TYIFuj9sqJhv
File Data
data
/ Required
fileData
Provide data to be uploaded to your desired SharePoint drive.
These are my file contents.
File Name
string
/ Required
fileName
Provide a string value for the name of the new file.
reports.csv
Folder ID
string
folderId
Provide the unique identifier of a Sharepoint folder Id.
01Q7VXAXZW7LCB32ODBRCKZNSJIC544FXU

Changelog​

2025-07-21​

Added support for additional GraphQL URLs to expand API capabilities.

2025-07-15​

Added OAuth 2.0 Client Credentials connection type for enhanced authentication options.