Workflow blocks
Google Sheets
Trigger workflow when Google Sheets data changes
trigger/google-sheets — Trigger workflow when Google Sheets data changes.
Where it appears
The Google Sheets block is a trigger — it starts a workflow. Add it from the Triggers group in the Workflow Builder.
Fields
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
spreadsheetId | text | Yes | — | The Google Sheets spreadsheet to watch, given as its ID or full URL. Changes to this spreadsheet trigger the workflow. |
sheetName | text | No | — | Name of the specific tab within the spreadsheet to watch. Leave empty to watch the default sheet. |
pollingInterval | select | Yes | 5min | How often Stylo checks the spreadsheet for new or changed rows. Options: 1min, 5min, 15min, 30min, 1hour. |
Inputs and outputs
Inputs are the configurable fields above. The block produces these outputs:
Outputs
Reference an output downstream with <Google Sheets.field>.
| Name | Type | Description |
|---|---|---|
triggered | boolean | Whether trigger fired |
timestamp | number | Trigger timestamp |
row | json | New or changed row data |
Example
A minimal configuration for this block:
{
"type": "trigger/google-sheets",
"config": {
"spreadsheetId": "<PreviousStep.field>",
"pollingInterval": "5min"
}
}Limits and failure modes
- Requires a connected Google integration. Calls fail if that integration is disconnected or its authorization has expired.
- Required fields (
spreadsheetId,pollingInterval) must be set, or the block fails validation before it runs.