View as Markdown
Google Sheets icon

Google Sheets TRIGGER

New Updates (Instant)

Emit new event each time a row or cell is updated in a spreadsheet.
  • Trigger
  • Polling
  • OAuth
  • Webhook delivery

IMPLEMENTATION

Deploy this event source

Connect the user's Google Sheets 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_sheets-new-updates",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    google_sheets: { authProvisionId: "apn_xxxxxxx" },
    timer: { "intervalSeconds": 900 },
    watchedDrive: "Drive",
  },
  webhookUrl: "https://example.com/webhooks/google-sheets",
})

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 Updates (Instant) configuration
Property Type Description
timer Push notification renewal schedule $.interface.timer
The Google Drive API requires occasionally renewal of push notification subscriptions. This runs in the background, so you should not need to modify this schedule.
Required
watchedDrive Drive string
Defaults to My Drive. To select a Shared Drive instead, select it from this list.
Optional Dynamic
sheetID Spreadsheet ID string
Select a spreadsheet or provide a spreadsheet ID
Required Dynamic
watchDrive Watch Drive boolean
Set to true to watch the drive for changes. May reduce rate limiting.
Optional
worksheetIDs Worksheet ID(s) integer[]
Select one or more worksheet(s), or provide an array of worksheet IDs.
Required Dynamic
maxRows Max Rows to Monitor integer
Maximum number of rows to monitor for changes. Defaults to 10000. Increase with caution as larger values may cause memory issues.
Optional

01

Connect

Your user authorizes Google Sheets 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_sheets-new-updates
Version
0.3.8
App
Google Sheets
Authentication
OAuth
Delivery
Polling source
Output
Events emitted by Google Sheets.