Upsert Row

Google / Google Sheets

Upsert Row

Insert a new row or update an existing row in a Google Sheet based on a match in a specific column.

googleSheetsUpsertRow

Permissions

Optional permissions

There are no items to display.

Parameters

Name	Type	Description	Required
spreadsheetId	file	Select the Google Sheets file where the row should be inserted or updated.	Yes
sheetName	mustache	Name of the sheet (tab) to search and upsert the row in (e.g. "Sheet1").	Yes
matchColumn	mustache	Column used as the unique identifier for matching rows (e.g. "A" for the first column).	Yes
matchValue	mustache	Value to search for in the match column. If found, that row will be updated; if not, a new row will be inserted.	Yes
valueInputOption	string	How to treat the cell values: RAW = store exactly as given, USER_ENTERED = let Sheets parse values and formulas.	Yes
values	array (mustache)	Full row values to write.	Yes

Returns

Name	Type	Description
status	string	INSERTED, UPDATED, or ERROR.
sensitive.spreadsheetId	string	Spreadsheet ID.
sensitive.sheetName	string	Sheet name where the row was written.
sensitive.updatedRange	string	Range that was inserted or updated.
sensitive.matched	boolean	Whether a matching row was found before writing.

Step 01

Open your tool setup

Start from the tool workspace where you want to add a new app.

Step 02

Go to tools and create button

Open the Tools page, then click the Create button to start adding a new app.

Step 03

Choose Internal or External work

Choose Internal or External work, then select an app action.

Step 04

Select app to install to Knoon

Pick the app you want to install to Knoon and complete the setup flow.

Step 05

Success!

The app has been installed successfully and is ready to use in your workflow.

Power your business with Knoon's Agentic AI today.

Join businesses already resolving thousands of customer inquiries and sales leads with Knoon.

See how to install an app in your tool