feishu

Feishu/Lark nodes for n8n — send messages, manage Bitables, process approvals. Free tier + Pro license.

Package Information

Released: 3 mo ago
Downloads: 52 weekly / 1,358 monthly
Latest Version: 2.1.3
Author: FileMaster Pro

Available Nodes

Feishu / Lark
Feishu/Lark integration — messaging, Bitable CRUD, approvals, calendar, contacts
Feishu / Lark Trigger
Listen for Feishu/Lark events: incoming messages, approval changes, Bitable updates

Documentation

@lixiongwei/n8n-nodes-feishu

Feishu / Lark integration nodes for n8n — messaging, Bitable CRUD, approvals, calendar & contacts.
Free tier + Pro License. Includes workflow templates.

📦 Install

npm install @lixiongwei/n8n-nodes-feishu

Requires: n8n self-hosted. (n8n Cloud does not support community nodes.)

🎮 Capabilities

🆓 Free

Category Operation Description
Messaging Send Text Message Send plain text to users or groups
Trigger Message Received Webhook — fires when the bot receives a message

⭐ Pro — $29 one-time (get a key)

Category Operations
Messaging Send Card Message (with Markdown & color), Send Image, Send File, Batch Send to multiple recipients
Bitable Read Records, Create Record, Update Record, Delete Record, Search Records, List Tables
Approvals List Pending, Get Detail, Approve, Reject
Calendar List Events, Create Event
Contacts Get User Info (by Open ID / Email / Mobile), Search Users

🚀 Quick Start (3 steps)

1. Create a Feishu/Lark app

  1. Go to Feishu Dev Console (or Lark Dev Console)
  2. Create an Enterprise Internal App
  3. Enable Bot capability (App Capabilities → Bot → Enable)
  4. Go to Permissions → add at minimum:
    • im:message:send_as_bot (send messages)
    • contact:contact.base:readonly (for Contacts operations)
  5. Go to Version Management → Create version → Publish
  6. Copy your App ID and App Secret from Credentials & Basic Info

2. Configure n8n

  1. n8n → Credentials → New → search Feishu → select Feishu / Lark API
  2. Choose your platform (Feishu for China, Lark for International)
  3. Enter App ID + App Secret
  4. (Optional) Enter License Key for Pro features

3. Start building

Drag the Feishu / Lark node onto your canvas → select a Resource → select an Operation → configure → test.

📋 Included Workflow Templates

Import from node_modules/@lixiongwei/n8n-nodes-feishu/workflows/ (n8n → Import from File):

# File What it does Key Feishu nodes used
01 wf-01-webhook-to-feishu.json Any external event → Feishu card Send Card, severity colors
02 wf-02-scheduled-report.json Daily data pull → format → Feishu card Send Card, Cron
03 wf-03-alert-escalation.json Site monitor → alert card + batch notify Send Card, Batch Send
04 wf-04-form-to-bitable.json Form submit → lookup user → Bitable write → card notify Contacts, Bitable Create, Send Card
05 wf-05-approval-auto-remind.json Check pending approvals → auto-remind approvers Approvals List, Send Card
06 wf-06-calendar-weekly-digest.json Monday morning → push this week's events Calendar List, Send Card
07 wf-07-rss-digest.json Pull data feed → archive to Bitable → push card Bitable Create, Send Card
08 wf-08-github-to-feishu.json GitHub webhook → card for Push/PR/Issue Send Card, Webhook

🔧 Common Patterns

I want to... Use this
CI/CD or form → Feishu notification wf-01 — Webhook → Card
Daily data report in Feishu wf-02 — Cron → Fetch → Card
Downtime alert + notify on-call team wf-03 — Check → If → Card + Batch
Form → CRM with user lookup wf-04 — Webhook → Contacts → Bitable → Card
Auto-remind pending approvals wf-05 — Cron → List Approvals → Card
Weekly meeting digest wf-06 — Cron → List Events → Card
RSS/data feed → archive + push wf-07 — Cron → Fetch → Bitable → Card
GitHub events → team channel wf-08 — Webhook → Card

⚠️ Troubleshooting

Error Cause Fix
Bot ability not activated (230006) Bot not enabled in app App Capabilities → Enable Bot → Republish
Permission denied (99991672) Missing API scope Permissions → Add required scope → Republish
Recipient ID not found (99992351) Wrong ID type or not in app scope Use Contacts → Get User Info to find the correct ID
Invalid tenant access token Wrong App ID or Secret Double-check from Developer Console → Credentials
This is a Pro feature No license key Get one at the Gumroad link, or use a Free operation
Workflow stuck spinning Method is GET instead of POST Check the node configuration — content-sending operations need POST
Webhook URL not receiving events App not configured for events Add Request URL in Feishu Dev Console → Event Subscriptions

🌍 Feishu vs Lark

Feishu (飞书) and Lark share the same API but use different domains:

Platform API Base Used in
Feishu open.feishu.cn China
Lark open.larksuite.com International (Singapore, US, etc.)

Choose the correct platform in your n8n credentials. If you get 99991663 errors, you likely have the wrong platform selected.

💰 License

npm install → FREE features work immediately
         ↓
  Try Pro operation → prompted for License Key
         ↓
  Get Key: https://1717465779306.gumroad.com/l/feishu-pro
         ↓
  Enter Key in credentials → ALL features unlocked forever

One-time payment. No subscription. Lifetime access.

  • n8n version: 1.x+ (v2 recommended)
  • Feishu API: v3
  • License: MIT
  • Support: Reply on n8n Community Forum

Discussion