Actions21
- App Actions
- Table Actions
- View Actions
- Record Actions
- Field Actions
Overview
The node enables creating records in a specified table within a Lark Suite Bitable app. It is useful for automating data entry into Lark Suite's collaborative database tables, such as adding new rows of structured information programmatically.
Common scenarios include:
- Automatically logging form submissions or survey responses into a Lark Bitable.
- Syncing data from other apps or services into Lark Suite tables.
- Batch inserting multiple records at once to streamline workflows.
For example, you could use this node to add new customer entries into a CRM table stored in Lark Bitable whenever a new lead is captured on your website.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method to authenticate API requests. Options: "Tenant Token" or "OAuth2". |
| App Token | The unique token identifying the target Lark Bitable app where records will be created. |
| Table Id | Identifier of the specific table within the app where records should be added. |
| Records | Collection of record items to create. Each item contains a JSON object representing the fields and values for one record. Multiple records can be added in one execution. |
| Custom Body | Optional raw JSON body to send instead of using the structured "Records" input. Allows full customization of the request payload. |
| Options > Use Custom Body | Boolean flag to toggle between using the structured "Records" input or providing a custom JSON body. |
Output
The node outputs JSON data representing the response from the Lark Suite API after attempting to create the records. This typically includes details about the newly created records, such as their IDs and field values as stored in the table.
If binary data were involved (not indicated here), it would represent file attachments or similar content, but this node focuses on JSON record creation only.
Dependencies
- Requires access to Lark Suite Open APIs.
- Needs either a Tenant Token or OAuth2 credentials configured in n8n for authentication.
- The base URL for API requests is
https://open.larksuite.com/open-apis. - Proper permissions on the Lark Bitable app and table are necessary to create records.
Troubleshooting
- Invalid App Token or Table ID: Ensure the app token and table ID are correct and correspond to existing resources in Lark Bitable.
- Authentication Errors: Verify that the selected authentication method is properly configured with valid credentials.
- Malformed Records Data: When using the structured "Records" input, ensure each record's fields are valid JSON objects matching the table schema.
- Custom Body Issues: If using the custom JSON body option, confirm the JSON structure matches the API requirements exactly.
- API Rate Limits or Permissions: Check if the API key has sufficient permissions and that rate limits have not been exceeded.