Feishu Node

Actions61

Overview

The "搜索日历" (Search Calendar) operation of the custom Feishu Node allows users to search for public or primary user calendars in Feishu by specifying a keyword. This is useful for organizations or individuals who need to programmatically discover and list calendars based on their titles or descriptions, such as when integrating calendar data into workflows, automating event management, or building calendar dashboards.

Practical examples:

Automatically listing all team calendars containing a specific project name.
Searching for public holiday calendars relevant to a region or department.
Integrating with other n8n nodes to trigger actions based on available calendars.

Properties

Name	Type	Meaning
搜索关键字	String	The search keyword. The API will look for public calendars or the user's main calendar whose title or description contains this keyword.
每页数量	Number	Maximum number of calendars returned per request. The maximum allowed value is 50.
分页标记	String	Pagination token. Leave empty for the first request to start from the beginning; use the returned token for subsequent paginated requests.

Output

The node outputs an array of JSON objects, each representing a calendar that matches the search criteria. The structure of each output item typically includes fields such as:

{
  "id": "calendar_id",
  "name": "Calendar Title",
  "description": "Description of the calendar",
  // ...other calendar metadata fields
}

If an error occurs and "Continue On Fail" is enabled, the output will include an error field describing the issue.

Dependencies

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

Troubleshooting

Common Issues:

Invalid Credentials: If the Feishu API credentials are missing or incorrect, authentication errors will occur.
API Limits: Exceeding the maximum page size (more than 50) may result in API errors.
Empty Results: Using a search keyword that does not match any calendar will return an empty array.

Error Messages:

"未实现方法: calendar.calendar:search": Indicates the requested resource-operation combination is not implemented.
Errors with "NodeApiError": These are API-related issues, often including more details in the error field if "Continue On Fail" is enabled.

Resolution Steps:

Double-check your Feishu credentials in n8n.
Ensure the "每页数量" property does not exceed 50.
Verify the search keyword is correct and expected to yield results.