Feishu

Availability

Core Standard Plus Pro Enterprise Flex Self-Managed Enterprise PyAirbyte

Support Level

Marketplace

Connector Version

0.0.6 (last updated a month ago)

Data workers used

0.2 per sync (Learn more)

Definition ID

3f1aa18a-a111-4e3b-8cac-9b79a091cc13

This page contains the setup guide and reference information for the Feishu (also known as Lark) source connector.

The Feishu source connector syncs records from a Feishu/Lark Bitable (Base) table using the 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

Setup guide

Step 1: Create a custom app in the Feishu Open Platform

1. Go to the Feishu Open Platform Developer Console (or Lark Developer Console for international accounts).
2. Click Create Custom App and fill in the app name and description.
3. After creation, navigate 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-related scopes required for reading records (for example, bitable:app:readonly or bitable:app).
3. Publish the app or submit it for review, depending on your organization's requirements.

Step 3: Find your Bitable App Token and Table ID

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

Step 4: Set up the connector in Airbyte

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 the following sync modes:

• Full Refresh - Overwrite
• Full Refresh - Append

Supported streams

Stream	Primary key	Pagination	Incremental
records	record_id	Cursor-based (page_token)	No

The records stream returns all records from the specified Bitable table. Each record includes a record_id, an optional id, and a fields object containing the values for each column in the table. The structure of the fields object depends on the columns defined in your Bitable table.

Limitations

• This connector syncs records from a single Bitable table per configured source. To sync multiple tables, create a separate source for each.
• Only full refresh sync is supported. Incremental sync is not available.

IP allow list

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

Reference

Config fields reference

Field

Type

Property name

string

app_id

string

app_secret

string

app_token

string

lark_host

string

table_id

number

page_size

Changelog

Expand to review

Version	Date	Pull Request	Subject
0.0.7	2026-06-02	78689	Update dependencies
0.0.6	2026-04-28	77250	Update dependencies
0.0.5	2026-04-21	76574	Update dependencies
0.0.4	2026-03-31	75717	Update dependencies
0.0.3	2026-03-17	74640	Update dependencies
0.0.2	2026-02-24	73777	Update dependencies
0.0.1	2026-02-19	71256	Initial release by @WYW-min via Connector Builder