Definition and Usage
Use this command to add a new record to a specific table in Lark Base. You can target the table either by its human-readable name or its unique ID, then provide the record content to insert. Choose the locating mode that best fits your workflow: use the name for readability or the ID for precision and stability.
Parameter Values
Input Parameters
Parameter Name | Description | Possible Values | Required | Options / Notes |
Lark Base | The connected Lark Base object to use for this action. | Connected Lark Base object | Yes | Must be created by the Connect Lark Base command beforehand. |
Locating mode | How to identify the target table. | By name, By ID | Yes | Choose By name to reference a table by its title; choose By ID for unambiguous targeting across renames. |
Data table name | The name of the table to receive the new record. | Text | Required when Locating mode = By name | Ensure exact match; names can be case-sensitive or duplicated across spaces. |
Data table ID | The unique ID of the table to receive the new record. | Text | Required when Locating mode = By ID | Prefer when tables may be renamed or when multiple tables share similar names. |
Record content | The field values to insert as the new record. | Structured text/value set | Yes | Provide values that match the table’s field configuration; include mandatory fields to avoid insertion errors. |
Advanced Settings
No advanced settings available.
Error Handling
Parameter Name | Description |
Throw error & stop | When an error occurs, the action will stop execution. |
Retry command | The action retries the command if an error occurs. |
Ignore error & continue | The action ignores the error and continues workflow execution. |
Variables Produced
This action can produce a variable containing the ID of the newly created record. Use it later in the workflow to update the same record, link it to other records, or log audit information.
Using Variables in Conditions
You can pass dynamic values from earlier steps into this command. For example, select a previously connected Lark Base object, supply a table name or ID computed at runtime, or build the record content from extracted data. If a field in the UI shows a {x} indicator, it supports variables. Use variables to keep your automations adaptive to different bases, tables, and row data without hardcoding.
Notes
Connect to Lark Base before using this command; ensure valid authentication and workspace access.
Choose the locating mode first; then provide either the table name or the table ID accordingly.
Ensure Record content aligns with the table’s schema; include all required fields and valid data types to prevent insertion failures.
Using table ID is more resilient if tables are renamed or localized.
Capture the returned record ID to chain follow-up actions such as updates, lookups, or linking.