Feishu Node

Actions61

Overview

This n8n custom node is designed to interact with the Feishu (Lark) calendar API, specifically for the operation of "添加日程参与人" (Add Event Attendees) to a specified calendar event. It allows users to programmatically add one or more attendees to an existing calendar event within a chosen calendar, with options for notification and attendee management.

Common Scenarios:

Automating the process of inviting participants to meetings or events scheduled in Feishu calendars.
Integrating with other systems (e.g., CRM, HR tools) to automatically update event attendees based on business logic.
Managing recurring events by adding attendees to specific instances.

Practical Example:
When a new employee joins a team, this node can be used in an onboarding workflow to automatically add them as an attendee to all relevant team meetings in Feishu.

Properties

Name	Type	Meaning
日历 ID	String	The ID of the calendar where the event is located. Obtainable via calendar list/search APIs.
日程 ID	String	The ID of the event to which attendees will be added. Obtainable via event creation/list/search APIs.
参与人列表(attendees对象)	JSON	List of attendees to add. Should follow the structure defined in Feishu API documentation.
是否发送通知	Boolean	Whether to send notifications to the newly added attendees.
重复日程实例时间戳	String	Timestamp of the recurring event instance to modify. Only needed when modifying a single instance of a recurring event.
启用会议室管理员身份	Boolean	Whether to enable meeting room admin privileges for this operation.
添加操作人为参与人	Boolean	Whether to add the operator (the user performing the action) as an attendee.
用户 ID 类型	Options	Type of user ID used for attendees. Options: Open ID, Union ID, User ID.

Output

The node outputs a JSON object for each processed input item. The output structure typically includes:

The response from the Feishu API after attempting to add attendees.
If an error occurs and "Continue On Fail" is enabled, the output will include an error field with the error message, and possibly additional error details if available.

Example Success Output:

{
  "event_id": "xxxxxx",
  "attendees": [
    {
      "user_id": "ou_xxxx",
      "status": "accepted"
    }
  ],
  // ...other fields as returned by Feishu API
}

Example Error Output (when Continue On Fail is enabled):

{
  "error": "Invalid calendar_id"
}

Note: The exact output fields depend on the Feishu API's response.

Dependencies

External Service: Requires access to the Feishu (Lark) Calendar API.
Credentials: Needs valid Feishu API credentials configured in n8n (feishuCredentialsApi).
Environment: No special environment variables are required beyond standard n8n credential setup.

Troubleshooting

Common Issues:

Invalid Calendar or Event ID: Ensure that the provided calendar and event IDs exist and are accessible with the given credentials.
Malformed Attendees List: The 参与人列表(attendees对象) property must match the expected JSON structure as per Feishu API documentation.
Insufficient Permissions: The API credentials must have permission to manage calendar events and attendees.
Recurring Event Instance Issues: If specifying 重复日程实例时间戳, ensure it matches an actual instance timestamp.

Error Messages:

"未实现方法: calendar.calendar:addEventAttendees": Indicates the requested resource/operation combination is not implemented in the node.
"Invalid calendar_id" or similar: Returned from Feishu API if the calendar ID is incorrect.
"NodeApiError": General API error; check the error details for more information.

How to Resolve:

Double-check all IDs and input formats.
Refer to Feishu API documentation for correct attendee object structure.
Ensure your Feishu app has the necessary permissions.