Connect a custom Feishu app and import content

First create and publish a custom enterprise app in your company's Feishu tenant. An Owner or Admin of the TabTin organization then configures it. Afterwards, each employee authorizes their own Feishu account and can import data they are permitted to access.

Before you begin, open theFeishu Open Platformand confirm that you are signed in to the company tenant you want to connect to TabTin.

---

1. Create an app

1. OpenFeishu Open Platformand confirm that your company tenant is active.
2. Create acustom enterprise app.

---

2. Grant permissions

Open the app'sPermission management, chooseBulk import, paste the JSON below, and confirm:

{
  "scopes": {
    "tenant": [
      "bitable:app:readonly",
      "board:whiteboard:node:read",
      "docs:document.content:read",
      "docx:document:readonly",
      "drive:drive.metadata:readonly",
      "drive:drive:readonly",
      "search:docs:read",
      "wiki:node:read",
      "wiki:node:retrieve",
      "wiki:space:retrieve",
      "wiki:wiki:readonly"
    ],
    "user": [
      "bitable:app:readonly",
      "board:whiteboard:node:read",
      "docs:document.content:read",
      "docx:document:readonly",
      "drive:drive.metadata:readonly",
      "drive:drive:readonly",
      "offline_access",
      "search:docs:read",
      "wiki:node:read",
      "wiki:node:retrieve",
      "wiki:space:retrieve",
      "wiki:wiki:readonly"
    ]
  }
}

---

3. Configure the redirect URL

OpenSecurity settings → Redirect URL. Add the URL provided by TabTin exactly as shown:

https://api.tabtin.com/api/integrations/feishu/oauth/callback

---

4. Publish the app

1. OpenVersion management & release. Create a version, ensure its availability includes every employee who needs to import data, then submit it for release.
2. Wait for approval from the enterprise admin.

---

5. Configure the enterprise app in TabTin

Only an organization Owner or Admin can complete this step.

1. In TabTin, openDrive → New → External resource → Feishu.
2. Return to the Feishu Open Platform and open the custom enterprise app.
3. UnderCredentials & basic informationcontains the values to copy: App ID and App Secret.
4. Return to TabTin, enter the App ID and App Secret, and clickVerify & save.

The TabTin backend stores the App Secret in encrypted form. It is never displayed again in the interface, API, or logs, and you do not need to send it to a support contact.

After the App ID or App Secret changes, every member must authorize their Feishu account again.

---

6. Employee authorization and import

1. Use your own TabTin account to enter the organization.
2. OpenDrive → New → External resource → Feishu.
3. If the enterprise app is not yet configured, wait for an Owner or Admin to finish setup.
4. ClickAuthorize my Feishu accountand complete personal authorization in the browser.
5. Select and import the Bases, docs, or wiki content you are permitted to access.

Members must authorize again after an admin adds Feishu permissions or updates app credentials. If permissions are published but the resource list remains empty, disconnect Feishu in TabTin and authorize again.

---

Still stuck?

Confirm that the app is published, the employee is included in its availability, and authorization has been repeated. If importing still fails, send a screenshot of the failing step and error to contact@larchiveai.com. We will help you investigate.