View as Markdown
Google Drive icon

Google Drive TRIGGER

New or Modified Folders (Instant)

Emit new event when a folder is created or modified in the selected Drive
  • Trigger
  • Polling
  • OAuth
  • Webhook delivery

IMPLEMENTATION

Deploy this event source

Connect the user's Google Drive account, configure the source, and choose the webhook where your backend receives events.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const deployed = await pd.triggers.deploy({
  id: "google_drive-new-or-modified-folders",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    google_drive: { authProvisionId: "apn_xxxxxxx" },
    drive: "Drive",
    timer: { "intervalSeconds": 900 },
  },
  webhookUrl: "https://example.com/webhooks/google-drive",
})

console.log(deployed.id)

MCP exposes on-demand actions. Event sources are deployed through the Connect SDK or API because they continue listening after the initial request.

SCHEMA

Configuration

These inputs define which events the source watches. Dynamic options are loaded from the connected account.

New or Modified Folders (Instant) configuration
Property Type Description
drive Drive string
The drive to watch. Defaults to My Drive. To watch a Shared Drive, select it from this list.
Required Dynamic
timer Push notification renewal schedule $.interface.timer
The Google Drive API requires occasional renewal of push notification subscriptions. This runs in the background, so you should not need to modify this schedule.
Required
updateTypes Types of updates string[]
Deprecated and ignored.
Optional
changesPageSize Changes Page Size integer
Maximum number of changes to fetch per API call (max 1000). Lower values mean more API calls per run. Example: 500
Optional
maxEmitsPerRun Max Events Per Run integer
Stop after about this many events and resume on the next run (max 5000). A single page of changes larger than this is still processed in full. Example: 1000
Optional
folderId Parent Folder string
The ID of the parent folder which contains the folders. If not specified, it will watch all folders from the drive's top-level folder.
Optional Dynamic
includeSubfolders Include Subfolders boolean
Whether to include subfolders of the parent folder in the changes.
Optional

01

Connect

Your user authorizes Google Drive through Pipedream managed auth.

02

Deploy

Your backend deploys this source with that user's own configuration.

03

Webhook delivery

Every event is sent to the HTTP endpoint you choose when you deploy the source — after each poll.

OR

On-demand retrieval

No webhook required. Your app or agent can fetch recent events from the trigger events API.

Registry key
google_drive-new-or-modified-folders
Version
1.0.0
App
Google Drive
Authentication
OAuth
Delivery
Polling source
Output
Events emitted by Google Drive.