Upsert Row

Microsoft / Microsoft Excel

Upsert Row

Insert a new row or update an existing row in an Excel worksheet based on a match in a specific column.

microsoftExcelUpsertRow

Permissions

Optional permissions

Parameters

Name	Type	Description	Required
workbookId	file	Select the Excel workbook where the row should be inserted or updated.	Yes
worksheetName	mustache	Name of the worksheet (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 Excel 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.workbookId	string	Workbook ID.
sensitive.worksheetName	string	Worksheet name.
sensitive.range	string	Range written.
sensitive.matched	boolean	Whether a matching row was found before writing.
sensitive.matchColumn	string	Match column used.

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