Feishu Node

Actions61

Overview

This n8n custom node interacts with the Feishu (Lark) calendar API to retrieve detailed information about a specific event ("日程") from a specified calendar. The "获取日程" (Get Event) operation is useful for automating workflows that need to fetch, process, or synchronize calendar events—such as sending reminders, aggregating meeting data, or integrating with other scheduling tools.

Practical examples:

Fetching meeting details to send automated notifications.
Retrieving event information for reporting or analytics.
Integrating Feishu calendar events into other business systems.

Properties

Name	Type	Meaning
日历 ID	String	The ID of the calendar containing the event. Obtainable via main calendar info, calendar list, or search APIs.
日程 ID	String	The unique identifier of the event. Obtainable via event creation, event list, or search APIs.
是否需要返回飞书视频会议（VC）的会前设置	Boolean	Whether to include pre-meeting settings for Feishu video conferences in the response.
是否需要返回参与人信息	Boolean	Whether to include attendee information in the response.
返回的最大参与人数量	Number	The maximum number of attendees to return.
用户 ID 类型	Options	The type of user ID used in responses. Options: Open ID, Union ID, User ID.

Output

The node outputs a JSON object containing the details of the requested calendar event. The structure typically includes:

Event metadata (title, description, start/end time, etc.)
Optionally, video conference settings if requested
Optionally, attendee information (up to the specified maximum)
User IDs in the selected format

If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message.

Example output:

{
  "event_id": "example123",
  "summary": "Team Meeting",
  "start_time": "2024-06-10T09:00:00Z",
  "end_time": "2024-06-10T10:00:00Z",
  "attendees": [
    {
      "user_id": "ou_xxx",
      "display_name": "Alice"
    }
  ],
  "meeting_settings": {
    "vc_enabled": true
  }
}

Note: Actual fields depend on Feishu's API response and selected options.

Dependencies

Feishu API: Requires valid Feishu credentials (feishuCredentialsApi) configured in n8n.
n8n Configuration: Node must be set up with access to the Feishu API and appropriate permissions to read calendar and event data.

Troubleshooting

Common issues:

Invalid Calendar or Event ID: If the provided IDs are incorrect or do not exist, the node will throw an error indicating the resource was not found.
Insufficient Permissions: Missing or invalid credentials will result in authentication errors.
API Rate Limits: Excessive requests may trigger rate limiting by Feishu.

Error messages:

"未实现方法: calendar.calendar:getEvent": Indicates the requested operation is not implemented in the node.
"NodeApiError": Usually means an error occurred while calling the Feishu API. The error message will provide more details (e.g., invalid parameters, permission denied).
If "Continue On Fail" is enabled, errors are returned in the output JSON under the error key.

How to resolve:

Double-check calendar and event IDs.
Ensure Feishu credentials are correctly configured and have necessary permissions.
Review error messages for hints on missing or misconfigured parameters.