Back to Google Sheets

Connect Knoon AI with Google Sheets (Google) to automate AI workflows.

Insert a new row or update an existing row in a Google Sheet based on a match in a specific column.
googleSheetsUpsertRow
BETA
Permissions
  • https://www.googleapis.com/auth/drive.file
Optional permissions
  • https://www.googleapis.com/auth/drive
Parameters
NameTypeDescriptionRequired
spreadsheetIdfile Select the Google Sheets file where the row should be inserted or updated.Yes
sheetNamemustache Name of the sheet (tab) to search and upsert the row in (e.g. "Sheet1").Yes
matchColumnmustache Column used as the unique identifier for matching rows (e.g. "A" for the first column).Yes
matchValuemustache Value to search for in the match column. If found, that row will be updated; if not, a new row will be inserted.Yes
valueInputOptionstring How to treat the cell values: RAW = store exactly as given, USER_ENTERED = let Sheets parse values and formulas.Yes
valuesarray (mustache)Full row values to write.Yes
Returns
NameTypeDescription
statusstring INSERTED, UPDATED, or ERROR.
sensitive.spreadsheetIdstring Spreadsheet ID.
sensitive.sheetNamestring Sheet name where the row was written.
sensitive.updatedRangestring Range that was inserted or updated.
sensitive.matchedboolean Whether a matching row was found before writing.