Lark Base V2 icon

Lark Base V2

Get and create data in Lark Base
Join our community

Actions2

Overview

The node enables creating multiple records at once in a specified table within Lark Base, a collaborative data platform. It is designed to batch-create up to 500 records per execution, which is useful for efficiently importing or syncing large datasets into Lark Base tables.

Common scenarios include:

  • Bulk uploading new entries from external sources.
  • Synchronizing data from other systems into Lark Base.
  • Automating record creation workflows where many records need to be added simultaneously.

For example, you might use this node to create product listings in a marketplace database by providing an array of product details as records.

Properties

Name Meaning
App Token The app_token of the Lark Base application, used to identify the target app.
Table ID The unique identifier of the table where records will be created.
Records JSON array of objects representing the records to create. Each object must have a fields property containing field-value pairs. Example: [{"fields":{"ASIN":"example123","Marketplace":"US","Organic":1.00}}]
User ID Type Specifies the category of user ID used for the operation. Options: Open ID, Union ID, User ID.
Client Token A unique identifier (UUID v4) for the operation to ensure idempotency (avoid duplicate operations).
Ignore Consistency Check Boolean flag indicating whether to bypass consistency checks during read/write operations.

Output

The node outputs the response from the Lark Base API after attempting to create the records. The main output is a JSON object that typically contains information about the created records, such as their IDs and any metadata returned by the API.

If the API supports it, the output may include details on success or failure for each record in the batch.

This node does not output binary data.

Dependencies

  • Requires an API key credential for authenticating with Lark Base.
  • The node internally obtains a tenant access token by making an authenticated request using the provided API credentials before sending the create records request.
  • Network access to https://open.larksuite.com/open-apis is required.

Troubleshooting

  • Invalid JSON in Records Parameter: If the "Records" input is not valid JSON or not an array, the node throws an error. Ensure the records are entered as a valid JSON array of objects with a fields property.
  • Failed to Get Tenant Access Token: This error indicates issues with authentication credentials or network problems when requesting the access token. Verify that the API credentials are correct and have necessary permissions.
  • Records Must Be an Array: The node expects the records parameter to be an array. Passing a single object or invalid structure will cause errors.
  • API Errors: Any error responses from the Lark Base API (e.g., rate limits, invalid table ID) will be surfaced as node errors. Review the error message and verify parameters accordingly.

Links and References

Discussion