# OneDrive - changes - Workflow trigger | Docs - nodulz

Source: https://nodulz.com/docs/nodes/onedrive_trigger

Language: en

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](/docs/credentials) (`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](/docs/credentials) 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

| Setting | Purpose and guidance |
| --- | --- |
| `credentialId`<br>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`<br>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`<br>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`<br>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`<br>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.

See also : [Expressions and data](/docs/expressions), [Executions](/docs/executions), [Node catalog](/docs/nodes).

## Explore further

- [Features - nodulz](https://nodulz.com/product/overview)
- [Node catalog - nodulz](https://nodulz.com/product/catalog)
- [MCP server - nodulz](https://nodulz.com/product/mcp)
- [Pricing - nodulz](https://nodulz.com/pricing)
- [Use cases and workflow automation - nodulz](https://nodulz.com/use-cases)
- [Choose what your workflows can do. - nodulz](https://nodulz.com/compare)
- [Documentation - nodulz](https://nodulz.com/docs)