Feishu Node

Actions61

Overview

This node interacts with the Feishu (Lark) platform to query information about a user's primary calendar. It is designed for scenarios where you need to retrieve details of a user's main calendar, such as integrating calendar data into workflows, synchronizing events, or automating notifications based on calendar information.

Practical examples:

Fetching a user's main calendar details to display in dashboards.
Using calendar info to trigger further automation, like scheduling meetings or reminders.
Integrating Feishu calendar data with other n8n nodes for cross-platform workflows.

Properties

Name	Type	Meaning
用户 ID 类型	options	Specifies the type of user ID to use when querying the primary calendar. Options include Open ID, Union ID, and User ID. This determines how the target user is identified in Feishu.

Output

The node outputs a JSON object containing the primary calendar's information for the specified user. The exact structure depends on the Feishu API response, but typically includes fields such as calendar ID, name, description, permissions, and other metadata relevant to the user's main calendar.

If an error occurs and "Continue On Fail" is enabled, the output will be:

{
  "error": "Error message here"
}

If the error is specifically from the Feishu API (NodeApiError), the error field may contain more detailed information from the API.

Dependencies

Feishu account: You must have valid Feishu credentials configured in n8n.
API Key/Credentials: The node requires the feishuCredentialsApi credential to authenticate requests.
n8n Configuration: Ensure that the Feishu credentials are set up in your n8n instance.

Troubleshooting

Common issues:

Missing or invalid credentials: If the Feishu credentials are not set up or are incorrect, the node will fail to authenticate.
Incorrect 用户 ID 类型: Providing an unsupported or mismatched user ID type may result in no data or errors from the Feishu API.
API limitations or permission errors: The authenticated user may lack permission to access the requested calendar.

Error messages:

未实现方法: 日历.查询主日历信息: Indicates that the requested resource-operation combination is not implemented in the node.
NodeApiError: Returned when the Feishu API responds with an error; check the error details for more information.
Generic error messages: Other exceptions will provide their message in the output if "Continue On Fail" is enabled.

How to resolve:

Double-check your Feishu credentials in n8n.
Verify that the 用户 ID 类型 matches the expected format for your Feishu environment.
Ensure the authenticated user has the necessary permissions in Feishu.