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 the Feishu Open Platform and confirm that you are signed in to the company tenant you want to connect to TabTin.

---

1. Create an app

1. Open Feishu Open Platform and confirm that your company tenant is active.
2. Create a custom enterprise app.

---

2. Grant permissions

Open the app's Permission management, choose Bulk 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

Open Security 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. Open Version 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, open Drive → New → External resource → Feishu.
2. Return to the Feishu Open Platform and open the custom enterprise app.
3. Under Credentials & basic information contains the values to copy: App ID and App Secret.
4. Return to TabTin, enter the App ID and App Secret, and click Verify & 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. Open Drive → New → External resource → Feishu.
3. If the enterprise app is not yet configured, wait for an Owner or Admin to finish setup.
4. Click Authorize my Feishu account and 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.