Skip to documentation
Google Sheets integration

Batch Update Cells

Perform Batch Update Cells through Google Sheets.

View as Markdown
google_sheets_batch_update_cells
writegoogle_sheets

Inputs

  • google_sheets_account_id
    selectdynamic options
    Google Sheets Account Id

    Optional selected identifier or value. Retrieve allowed values from the dynamic options endpoint.

  • spreadsheet_id
    expressionrequired
    Spreadsheet Id

    Required literal value or workflow expression.

  • sheet_title
    selectrequireddynamic options
    Sheet Title

    Required selected identifier or value. Retrieve allowed values from the dynamic options endpoint.

  • header_row
    number
    Header Row

    Optional numeric value.

    Default: 1

  • headers
    expression
    Headers

    Optional literal value or workflow expression.

  • row_updates
    jsonrequired
    Row Updates

    Required JSON value.

  • value_input_option
    select
    Value Input Option

    Optional selected identifier or value.

    Default: "RAW"

    Options: Raw ("RAW"), User Entered ("USER_ENTERED")

  • write_enabled
    boolean
    Write Enabled

    Optional true-or-false value.

    Default: false

Outputs

  • successSuccess
  • submittedSubmitted
  • write_skippedWrite Skipped
  • skip_reasonSkip Reason
  • spreadsheet_idSpreadsheet Id
  • row_update_countRow Update Count
  • updated_cellsUpdated Cells
  • updated_rowsUpdated Rows
  • errorError
  • error_messageError Message

Output schema completeness: best_effort_declared

Safety

External effect
write
Confirmation recommended
No
Retry safe
No
Dry run supported
No

Schemas

These schemas are first-pass authoring guidance. Runtime validation remains authoritative.

Input schema
{
  "type": "object",
  "required": [
    "spreadsheet_id",
    "sheet_title",
    "row_updates"
  ],
  "properties": {
    "headers": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "header_row": {
      "type": "number",
      "default": 1,
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "row_updates": {
      "description": "Required JSON value.",
      "x-workflow-field-type": "json"
    },
    "sheet_title": {
      "type": "string",
      "description": "Required selected identifier or value. Retrieve allowed values from the dynamic options endpoint.",
      "x-dynamic-options": true,
      "x-workflow-field-type": "select"
    },
    "write_enabled": {
      "type": "boolean",
      "default": false,
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    },
    "spreadsheet_id": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "value_input_option": {
      "enum": [
        "RAW",
        "USER_ENTERED"
      ],
      "type": "string",
      "default": "RAW",
      "description": "Optional selected identifier or value.",
      "x-workflow-field-type": "select"
    },
    "google_sheets_account_id": {
      "type": "string",
      "description": "Optional selected identifier or value. Retrieve allowed values from the dynamic options endpoint.",
      "x-dynamic-options": true,
      "x-workflow-field-type": "select"
    }
  },
  "additionalProperties": false
}
Output schema
{
  "type": "object",
  "properties": {
    "error": {},
    "success": {},
    "submitted": {},
    "skip_reason": {},
    "updated_rows": {},
    "error_message": {},
    "updated_cells": {},
    "write_skipped": {},
    "spreadsheet_id": {},
    "row_update_count": {}
  },
  "additionalProperties": true
}
View all Google Sheets actions