googlesheets

Append Values to Spreadsheet

TOOL
Slug
GOOGLESHEETS_SPREADSHEETS_VALUES_APPEND
Version
20261018_00
Toolkit
googlesheets
Tool to append values to a spreadsheet. Use when you need to add new data to the end of an existing table in a Google Sheet.
rangerequired
STRING
A1 notation range used to locate a logical table. New rows are appended after the last row of that table within this range. First call GOOGLESHEETS_GET_SHEET_NAMES with this exact spreadsheet_id and use one of the returned sheet names; sheet names are case-sensitive and default names like 'Sheet1' are unsafe guesses. Valid formats: exact sheet name only (e.g., 'Sales Data'), sheet-qualified column range (e.g., 'Sales Data!A:D'), or sheet-qualified cell range (e.g., 'Sales Data!A1:D100'). Do not pass bare ranges like 'A:F' or 'A1:D100' because they omit the sheet name. If the needed sheet is not returned, create it or ask the user instead of inventing a name. Sheet names with spaces need single quotes (auto-added). IMPORTANT: The append may land in different columns than specified due to API table detection. For strict column placement, use GOOGLESHEETS_SPREADSHEETS_VALUES_UPDATE instead. Always check updates.updatedRange in the response to verify where data was actually written.
valuesrequired
ARRAY<ARRAY>
2D array of values to append. Typically, each inner list is a ROW (majorDimension=ROWS). Use null/None for empty cells.
spreadsheetIdrequired
STRING
The spreadsheet ID (typically 44 characters containing letters, numbers, hyphens, and underscores). Found in the URL between /d/ and /edit. NOT the sheet name (tab name) - that belongs in the 'range' parameter.
majorDimension
STRING
How to interpret the 2D values array. Use ROWS for row-wise data (most common for appends). Use COLUMNS for column-wise data. Example: if A1=1,B1=2,A2=3,B2=4 then majorDimension=ROWS yields [[1,2],[3,4]] and majorDimension=COLUMNS yields [[1,3],[2,4]].
Options: ROWS, COLUMNS
insertDataOption
STRING
How the input data should be inserted.
Options: OVERWRITE, INSERT_ROWS
valueInputOptionrequired
STRING
How the input data should be interpreted.
Options: RAW, USER_ENTERED
includeValuesInResponse
BOOLEAN
Determines if the update response should include the values of the cells that were appended. By default, responses do not include the updated values.
responseValueRenderOption
STRING
Determines how values in the response should be rendered. The default render option is FORMATTED_VALUE.
Options: FORMATTED_VALUE, UNFORMATTED_VALUE, FORMULA
responseDateTimeRenderOption
STRING
Determines how dates, times, and durations in the response should be rendered. This is ignored if responseValueRenderOption is FORMATTED_VALUE. The default dateTime render option is SERIAL_NUMBER.
Options: SERIAL_NUMBER, FORMATTED_STRING