Microsoft 365 List

Microsoft 365 List

Certified

List SharePoint drive items

Lists files and folders from a document library or folder ID. Default fetchType is FETCH; STORE writes items as Ion to Kestra internal storage. Requires Microsoft Graph permissions Files.Read.All and Sites.Read.All.

yaml
type: io.kestra.plugin.microsoft365.sharepoint.List

List items in a SharePoint document library

yaml
id: microsoft365_sharepoint_list
namespace: company.team

tasks:
  - id: list
    type: io.kestra.plugin.microsoft365.sharepoint.List
    tenantId: "{{ secret('AZURE_TENANT_ID') }}"
    clientId: "{{ secret('AZURE_CLIENT_ID') }}"
    clientSecret: "{{ secret('AZURE_CLIENT_SECRET') }}"
    siteId: "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE"
    driveId: "b!BCTBCKSP50iysCOFPU"
    folderId: "root"

List items in a specific folder

yaml
id: microsoft365_sharepoint_list_folder
namespace: company.team

tasks:
  - id: list
    type: io.kestra.plugin.microsoft365.sharepoint.List
    tenantId: "{{ secret('AZURE_TENANT_ID') }}"
    clientId: "{{ secret('AZURE_CLIENT_ID') }}"
    clientSecret: "{{ secret('AZURE_CLIENT_SECRET') }}"
    siteId: "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE"
    driveId: "b!BCTBCKSP50iysCOFPU"
    folderId: "01BYE5RZ6QN3ZWBTURF3F43DSUNZYRZD5Q"
Properties

Azure client ID

Application (client) ID of the registered Entra ID app

Azure client secret

Client secret for the app registration; required for client-credentials flow

SharePoint site ID

Site identifier in Graph format hostname,siteId,webId

Azure tenant ID

Azure AD (Entra ID) tenant GUID used for Graph authentication

Drive ID

Document library ID; if omitted the first drive returned for the site is used

DefaultFETCH
Possible Values
STOREFETCHFETCH_ONENONE

The way you want to store the data

FETCH - outputs the messages as an output FETCH_ONE - outputs the first message only as an output STORE - stores all messages to a file NONE - no output

Defaultroot

Folder ID

Folder ID to list from; use 'root' for the document library root

Reference (ref) of the pluginDefaults to apply to this task.

Single item

Single item when fetchType is FETCH_ONE and an item exists

Definitions
createdDateTimestring
Formatdate-time

Creation time of the item

idstring

Item ID

isFileboolean

Whether the item is a file

isFolderboolean

Whether the item is a folder

lastModifiedDateTimestring
Formatdate-time

Last modified time of the item

namestring

Item name

sizeinteger

Item size in bytes

webUrlstring

Web URL of the item

List of items

Files and folders; populated when fetchType is FETCH or FETCH_ONE

Definitions
createdDateTimestring
Formatdate-time

Creation time of the item

idstring

Item ID

isFileboolean

Whether the item is a file

isFolderboolean

Whether the item is a folder

lastModifiedDateTimestring
Formatdate-time

Last modified time of the item

namestring

Item name

sizeinteger

Item size in bytes

webUrlstring

Web URL of the item

Total number of items

Count of items fetched from the folder

Formaturi

URI of stored items file

URI of the Ion file with items; populated when fetchType is STORE

Unitcount

Number of items returned

More Plugins in this Category

Stripe
Stripe

Tasks that interact with Stripe customers, payments, balances, and webhooks.

Business

15 tasks

1 blueprints

Klaviyo
Klaviyo

Tasks that interact with Klaviyo campaign APIs.

AIBusiness

7 tasks

3 blueprints