Back to Microsoft Excel
Connect Knoon AI with Microsoft Excel (Microsoft) to automate AI workflows.
Insert a new row or update an existing row in an Excel worksheet based on a match in a specific column.
microsoftExcelUpsertRow
BETA
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. |