Feishu Node icon

Feishu Node

Feishu Node

Actions61

Overview

This n8n custom node allows users to create calendar events in Feishu (飞书) by interacting with the Feishu Calendar API. The node is designed for automation scenarios where you need to programmatically add events to a specific Feishu calendar, such as syncing external schedules, automating meeting creation, or integrating with other business workflows.

Practical examples:

  • Automatically creating team meetings in a shared Feishu calendar when a new project task is assigned.
  • Syncing events from another calendar system into Feishu.
  • Scheduling reminders or appointments based on triggers from other n8n nodes.

Properties

Name Type Meaning
日历 ID String The unique identifier of the calendar where the event will be created. Obtainable via main calendar info, calendar list, or search APIs.
请求体 JSON The request body containing event details. Refer to Feishu API docs for structure.
幂等 Key String An idempotency key to prevent duplicate event creation. Must be unique per app and calendar.
用户 ID 类型 Options The type of user ID used (Open ID, Union ID, or User ID). Determines how attendees/organizers are identified.

Output

The node outputs a JSON object representing the result of the event creation operation. The structure typically includes:

  • Details of the created event (such as event ID, summary, start/end time, etc.), as returned by the Feishu Calendar API.
  • If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message (and possibly additional error details).

Example success output:

{
  "data": {
    "event": {
      "id": "event_xxx",
      "summary": "Team Meeting",
      "start_time": "...",
      "end_time": "...",
      // ...other event fields
    }
  }
}

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

{
  "error": "Invalid calendar_id"
}

Dependencies

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

Troubleshooting

Common Issues:

  • Invalid Credentials: If the Feishu API credentials are missing or incorrect, the node will fail to authenticate.
  • Missing Required Fields: Omitting mandatory properties like "日历 ID" or "请求体" will cause errors.
  • API Errors: If the Feishu API returns an error (e.g., invalid calendar ID, malformed request body), the node will output the error message.

Error Messages:

  • 未实现方法: calendar.calendar:createEvent: Indicates that the specified resource-operation combination is not implemented in the node.
  • Invalid calendar_id: The provided calendar ID does not exist or is inaccessible.
  • NodeApiError: General API error; check the error details for more information.

How to resolve:

  • Double-check your Feishu credentials and permissions.
  • Ensure all required input fields are filled correctly.
  • Refer to the Feishu API documentation for correct request body formatting.

Links and References

Discussion