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
- Go to the Feishu Open Platform Developer Console, or Lark Developer Console for international accounts.
- Click Create Custom App, then enter the app name and description.
- After creating the app, go to Credentials & Basic Info to find your App ID and App Secret.
Step 2: Grant Bitable permissions
- In your custom app’s settings, go to Permissions & Scopes.
- Add the Bitable scopes required to read records, such as
bitable:app:readonlyorbitable:app. - Publish the app or submit it for review, depending on your organisation’s requirements.
Step 3: Find the App Token and Table ID
- Open the Bitable (Base) you want to sync in your browser.
- Find the App Token in the URL path:
https://your-domain.feishu.cn/base/{app_token}. - Find the Table ID in the URL query parameter:
?table={table_id}.
Step 4: Set up the Airbyte connector
- In Airbyte, go to Sources and select Feishu.
- Enter the App ID and App Secret from Step 1.
- Enter the App Token and Table ID from Step 3.
- 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). - Optionally, adjust the Page Size (default: 100, maximum: 500).
- Click Set up source.
Supported sync modes
The Feishu source connector supports these sync modes:
Supported streams
| Stream | Primary key | Pagination | Incremental |
|---|---|---|---|
| records | record_id | Cursor-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
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.0.28 | 2026-11-10 | 91508 | Update dependencies |
| 0.0.27 | 2026-11-03 | 90539 | Update dependencies |
| 0.0.26 | 2026-10-27 | 89894 | Update dependencies |
| 0.0.25 | 2026-10-20 | 89219 | Update dependencies |
| 0.0.24 | 2026-10-13 | 88609 | Update dependencies |
| 0.0.23 | 2026-10-07 | 88298 | Fix 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.22 | 2026-10-06 | 87868 | Update dependencies |
| 0.0.21 | 2026-09-29 | 87166 | Update dependencies |
| 0.0.20 | 2026-09-22 | 86611 | Update dependencies |
| 0.0.19 | 2026-09-15 | 86064 | Update dependencies |
| 0.0.18 | 2026-09-08 | 85462 | Update dependencies |
| 0.0.17 | 2026-08-18 | 84561 | Update dependencies |
| 0.0.16 | 2026-08-11 | 83904 | Update dependencies |
| 0.0.15 | 2026-08-04 | 83444 | Update dependencies |
| 0.0.14 | 2026-07-28 | 82892 | Update dependencies |
| 0.0.13 | 2026-07-21 | 82387 | Update dependencies |
| 0.0.12 | 2026-07-14 | 81821 | Update dependencies |
| 0.0.11 | 2026-06-30 | 81054 | Update dependencies |
| 0.0.10 | 2026-06-23 | 80477 | Update dependencies |
| 0.0.9 | 2026-06-16 | 79796 | Update dependencies |
| 0.0.8 | 2026-06-09 | 79335 | Update dependencies |
| 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 |