---
title: "Sync To Feishu"
method: POST
path: "/api/sync/feishu/{list_id}"
tags: ["Sync"]
---

# Sync To Feishu

`POST /api/sync/feishu/{list_id}`

## Request

- Base URL: `https://api.kolens.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kolens.ai/api/sync/feishu/{list_id}`
- Auth: HTTP bearer

Export a KOL list to Feishu Bitable.

Behaviour:
- If no ``app_token`` is provided a brand-new Bitable is created and its
  URL is returned so you can open it directly.
- If ``app_token`` (and optionally ``table_id``) are provided the records
  are appended to that existing Bitable / table.
- Each KOL becomes one row: username, stats, tier, price estimate,
  outreach status, contact info (email / IG / YouTube / website), and
  growth trend.

Requires ``FEISHU_APP_ID`` and ``FEISHU_APP_SECRET`` to be set in the
KOLens API environment (obtain from https://open.feishu.cn/app — enable
scopes ``bitable:app:create`` and ``bitable:record:write``).

## Path parameters

- `list_id` string, required

## Request body

- FeishuSyncBody: Optional body for Feishu sync — omit to auto-create a fresh Bitable.
  - `bitable_name` string, nullable
  - `app_token` string, nullable
  - `table_id` string, nullable

## Response `200`

Successful Response

- FeishuSyncResult
  - `list_id` string, required
  - `list_name` string, required
  - `bitable_url` string, required
  - `app_token` string, required
  - `table_id` string, required
  - `synced` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kolens/apis/kolens-api.md) · [All operations](https://skmtc.dev/kolens/apis/kolens-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolens/apis/kolens-api/revisions/5d6865ab0a24?raw)