Advanced Analytica Advanced Analytica: IBOM
← All connectors
Feishu logo

Source connector

Feishu

Set up Feishu as a source and move its data into your chosen destination.

Version 0.0.28 community alpha

Feishu

Set up the Feishu source connector, also known as Lark, using this guide and reference information.

Sync records from a Feishu/Lark Bitable (Base) table using the Feishu source connector and Feishu Open Platform API.

Prerequisites

  • A Feishu or Lark account
  • A custom app created in the Feishu Open Platform (or Lark Developer) with Bitable read permissions
  • The App ID and App Secret for that custom app
  • A Bitable (Base) with at least one table you want to sync

Set up Feishu

Step 1: Create a custom app

  1. Go to the Feishu Open Platform Developer Console, or Lark Developer Console for international accounts.
  2. Click Create Custom App, then enter the app name and description.
  3. After creating the app, go to Credentials & Basic Info to find your App ID and App Secret.

Step 2: Grant Bitable permissions

  1. In your custom app’s settings, go to Permissions & Scopes.
  2. Add the Bitable scopes required to read records, such as bitable:app:readonly or bitable:app.
  3. Publish the app or submit it for review, depending on your organisation’s requirements.

Step 3: Find the App Token and Table ID

  1. Open the Bitable (Base) you want to sync in your browser.
  2. Find the App Token in the URL path: https://your-domain.feishu.cn/base/{app_token}.
  3. Find the Table ID in the URL query parameter: ?table={table_id}.

Step 4: Set up the Airbyte connector

  1. In Airbyte, go to Sources and select Feishu.
  2. Enter the App ID and App Secret from Step 1.
  3. Enter the App Token and Table ID from Step 3.
  4. If you use Lark (international), change the Lark Host to https://open.larksuite.com. The default (https://open.feishu.cn) is for Feishu (China mainland).
  5. Optionally, adjust the Page Size (default: 100, maximum: 500).
  6. Click Set up source.

Supported sync modes

The Feishu source connector supports these sync modes:

Supported streams

StreamPrimary keyPaginationIncremental
recordsrecord_idCursor-based (page_token)No

The records stream returns every record from the specified Bitable table. Each record includes a record_id, an optional id and a fields object. This object contains each table column’s values. The columns defined in your Bitable table determine the fields object’s structure.

Limitations

  • Each configured source syncs records from one Bitable table. To sync multiple tables, create a separate source for each table.
  • The connector supports full refresh sync only. Incremental sync isn’t available.

IP allow list

If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Changelog

Expand to review
VersionDatePull RequestSubject
0.0.282026-11-1091508Update dependencies
0.0.272026-11-0390539Update dependencies
0.0.262026-10-2789894Update dependencies
0.0.252026-10-2089219Update dependencies
0.0.242026-10-1388609Update dependencies
0.0.232026-10-0788298Fix SessionTokenAuthenticator expiration_duration ("7200" is not a valid ISO 8601 duration, so every check/sync failed with “Unable to parse duration string”); surface Feishu auth errors as config errors
0.0.222026-10-0687868Update dependencies
0.0.212026-09-2987166Update dependencies
0.0.202026-09-2286611Update dependencies
0.0.192026-09-1586064Update dependencies
0.0.182026-09-0885462Update dependencies
0.0.172026-08-1884561Update dependencies
0.0.162026-08-1183904Update dependencies
0.0.152026-08-0483444Update dependencies
0.0.142026-07-2882892Update dependencies
0.0.132026-07-2182387Update dependencies
0.0.122026-07-1481821Update dependencies
0.0.112026-06-3081054Update dependencies
0.0.102026-06-2380477Update dependencies
0.0.92026-06-1679796Update dependencies
0.0.82026-06-0979335Update dependencies
0.0.72026-06-0278689Update dependencies
0.0.62026-04-2877250Update dependencies
0.0.52026-04-2176574Update dependencies
0.0.42026-03-3175717Update dependencies
0.0.32026-03-1774640Update dependencies
0.0.22026-02-2473777Update dependencies
0.0.12026-02-1971256Initial release by @WYW-min via Connector Builder
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.