Feishu Node icon

Feishu Node

Feishu Node

Actions106

Overview

This node integrates with Feishu's calendar service to create new calendar events. It is useful for automating event scheduling within Feishu calendars, such as adding meetings, reminders, or appointments programmatically. For example, you can use this node to automatically create calendar events based on data from other workflows, like booking systems or task managers.

Properties

Name Meaning
日历 ID The ID of the calendar where the event will be created. This ID can be obtained via APIs that fetch primary calendar info, list calendars, or search calendars.
请求体 The JSON request body defining the event details. Refer to Feishu's official API documentation for the structure and fields supported when creating a calendar event.
幂等 Key An idempotency key unique within the app and calendar scope to prevent duplicate event creation. If the same key is used again, the event will not be recreated.
用户 ID 类型 The type of user ID used in the request. Options include: Open ID, Union ID, or User ID. This defines how users are identified in the event data.

Output

The node outputs an array of JSON objects representing the created calendar events. Each output item corresponds to one input item processed and contains the response data from the Feishu API about the newly created event.

If any errors occur during event creation and "Continue On Fail" is enabled, the output will include error information for the failed items instead of stopping execution.

Dependencies

  • Requires an API authentication token credential for Feishu.
  • Depends on Feishu Calendar API v4 for creating events.
  • The node expects proper configuration of credentials and network access to Feishu services.

Troubleshooting

  • Common issues:

    • Invalid or missing calendar ID will cause failures in event creation.
    • Incorrectly formatted JSON in the request body may lead to API errors.
    • Using a non-unique idempotency key might prevent new events from being created.
    • Network or authentication errors if API credentials are invalid or expired.
  • Error messages:

    • Errors thrown by the Feishu API are captured and can be seen in the node’s error output.
    • If "Continue On Fail" is disabled, the node stops on the first error; enabling it allows processing subsequent items.
    • Typical error resolution involves verifying calendar IDs, ensuring correct JSON structure, and checking API credentials.

Links and References

Discussion