OneDrive - changes

Node catalog Triggers

On this page

Detect added, modified or deleted files with delta polling.

Usage and specifics

Select a Microsoft Graph credential with resource permissions. OneDrive also accepts delegated OAuth. Triggers poll changes periodically; publish to activate them. Supply drive, site, list or user identifiers for the chosen operation.

Technical type : onedrive_trigger. Runtime : nodulz.

Credentials and prerequisites

Microsoft Graph (integration / microsoft_graph). OneDrive, SharePoint and Outlook with an Entra ID application.

Create credentials in your nodulz instance’s Credentials area, then select them on the node. Availability depends on ownership and sharing. See the credentials guide for access and rotation.

Parameters

Names below are technical keys. Defaults are not a ready-to-run configuration: complete fields required by your operation. Paths containing [] describe list items; some fields depend on the selected mode.

Parameter	Type	Default	Values / limits
`credentialId`	`string`	`""`	-
`userId`	`string`	`""`	-
`driveId`	`string`	`""`	-
`siteId`	`string`	`""`	-
`listId`	`string`	`""`	-
`itemId`	`string`	`"root"`	-
`folderId`	`string`	`"inbox"`	-
`calendarId`	`string`	`""`	-
`resource`	`enum`	`"drive"`	`drive`, `list`, `new_messages`, `messages`, `calendar`
`events`	`array`	`["changed","deleted"]`	-; min 1
`pollInterval`	`number`	`60`	-; ≥ 10, ≤ 86400
`startDateTime`	`string`	`""`	-
`endDateTime`	`string`	`""`	-
`testPayload`	`string`	`""`	-

Configuration help

credentialId Microsoft Graph credential: OneDrive: OAuth credential for a personal or business account, or an Entra ID application. SharePoint and Outlook: Entra ID application with admin consent and appropriate application permissions.
resource Changes to watch: New messages: only creations in the selected folder. Message changes: includes read/unread and moves. Calendar: primary calendar in a fixed date range.
events Changes: The first pass initializes tracking without triggering existing items. Graph groups additions and updates. Removal can also mean a move outside the scope. Changes are delivered after publishing and retried on errors; a duplicate remains possible after a crash.
pollInterval Interval (seconds): Between 10 and 86,400 seconds. Delta pages and delivered items are checkpointed across polls. An expired cursor requires resetting the trigger source.
testPayload Test data (JSON): Optional JSON object for manual tests. When empty, a sample is generated; testing this trigger does not call Microsoft.

Initial configuration

Initial catalog configuration example, to adapt before running. Keep secrets in credentials.

json

{
  "credentialId": "",
  "userId": "",
  "driveId": "",
  "siteId": "",
  "listId": "",
  "itemId": "root",
  "folderId": "inbox",
  "calendarId": "",
  "resource": "drive",
  "events": [
    "changed",
    "deleted"
  ],
  "pollInterval": 60,
  "startDateTime": "",
  "endDateTime": "",
  "testPayload": ""
}

Verification

Test with representative data. Check node output in the inspector and logs, then use editor mapping for downstream fields. A trigger test with a simulated payload does not validate external service delivery.