Feishu Node icon

Feishu Node

Feishu Node

Overview

This node is designed to update an event in a Feishu (Lark) calendar. It allows users to specify the target calendar and event, provide updated event details, and select the user ID type for the operation. This node is useful in scenarios where you need to automate the modification of existing calendar events, such as rescheduling meetings, updating event descriptions, or changing participants.

Practical examples:

  • Automatically update meeting times when project deadlines shift.
  • Change event details based on workflow triggers (e.g., CRM updates).
  • Batch-update multiple calendar events from external data sources.

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 ID of the event to update. Obtainable via event creation, event list, or search APIs.
请求体 JSON The request body with updated event details. See Feishu API documentation for structure.
用户 ID 类型 Options The type of user ID used in the request. Options: Open ID, Union ID, User ID. Default is Open ID.

Output

The node outputs the result of the update operation for each input item. The output is a JSON object reflecting the response from the Feishu API after attempting to update the event. If an error occurs and "Continue On Fail" is enabled, the output will include an error field with the error message.

Example success output:

{
  // ...fields returned by Feishu's update event API, e.g.,
  "event_id": "xxxx",
  "summary": "Updated Meeting",
  "start_time": "...",
  "end_time": "...",
  // etc.
}

Example error output (when Continue On Fail is enabled):

{
  "error": "Error message here"
}

Dependencies

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

Troubleshooting

Common Issues:

  • Invalid Calendar or Event ID: Ensure that both IDs are correct and exist in your Feishu account.
  • Malformed Request Body: The 请求体 (body) must match the expected structure; refer to the API documentation.
  • Insufficient Permissions: The provided credentials must have permission to update the specified calendar/event.
  • User ID Type Mismatch: Make sure the selected user ID type matches the format of the IDs you provide.

Error Messages:

  • "未实现方法: calendar.calendar:updateEvent": Indicates the operation is not implemented—check if the resource and operation names are correct.
  • "NodeApiError": Usually means the Feishu API returned an error. Check the error field for more details.
  • "Error message here": General errors; review the message for clues (e.g., invalid parameters, missing fields).

Links and References

Discussion