Feishu Node

Actions61

Overview

This node allows you to create a shared calendar in Feishu (Lark) via n8n. It is useful for automating the creation of calendars with specific titles, descriptions, visibility settings, colors, and aliases directly from your workflows. Common scenarios include onboarding new teams, automating project setup, or integrating calendar management into broader business processes.

Practical examples:

Automatically create a team calendar when a new project is started.
Set up department-specific calendars with predefined permissions and color coding.
Integrate with HR systems to generate shared leave or event calendars.

Properties

Name	Type	Meaning
日历标题	String	The title of the calendar. Maximum length: 255 characters.
日历描述	String	The description of the calendar. Maximum length: 255 characters.
日历公开范围	Options	The visibility of the calendar. Options: 私密 (Private), 仅展示忙闲信息 (Show only free/busy), 公开，他人可查看日程详情 (Public, others can view details).
日历颜色	Number	The color of the calendar, represented as an int32 RGB value. Will be mapped to the closest color in the Feishu client palette.
日历备注名	String	An alias for the calendar, effective only for the current user. Maximum length: 255 characters.

Output

The node outputs a JSON object containing the result of the calendar creation operation. The structure typically includes fields such as the calendar ID, summary, description, permissions, color, and any other metadata returned by the Feishu API. If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message.

Example output:

{
  "calendar_id": "cal_xxx",
  "summary": "Team Calendar",
  "description": "Project events",
  "permissions": "public",
  "color": -14513409,
  "summary_alias": "TeamCal"
}

If there is an error:

{
  "error": "Error message here"
}

Dependencies

Feishu account: You must have valid Feishu credentials configured in n8n (feishuCredentialsApi).
API access: Ensure your Feishu app has permission to manage calendars.
n8n configuration: No special environment variables are required beyond standard credential setup.

Troubleshooting

Missing Method Error:
Error message: 未实现方法: calendar.calendar:create
This means the requested resource-operation combination is not implemented. Double-check that you selected the correct resource and operation.
Authentication Errors:
If you see errors related to authentication, ensure your Feishu credentials are correctly set up in n8n and have the necessary permissions.
Validation Errors:
If input values exceed maximum lengths or use invalid formats (e.g., color not as int32), the Feishu API may reject the request. Check property requirements.
API Limitations:
If you hit rate limits or permission issues, review your Feishu app's API quotas and scopes.