飞书 icon

飞书

飞书 API 集成,支持多种飞书功能

Actions112

群组管理 → 创建群

AI-generated

Summary

Create a Feishu group chat and optionally invite users and bots. Configure the group’s identity, membership, message format, visibility, and approval settings; the operation sends a create-chat request for each input item.

Inputs

  • 凭证类型 (required) — Choose user-level or app-level Feishu credentials; app-level credentials are the default.
  • 用户 ID 类型 — Select the ID format used for user IDs, including the owner and invited users. Defaults to Open ID.
  • 设置机器人为管理员 — When an owner is specified, optionally make the bot that creates the group an administrator. Defaults to false.
  • UUID (去重) — Optional developer-generated request deduplication key, up to 50 characters. Requests with the same UUID and owner ID can create at most one group within 10 hours; omitting it allows each successful request to create a group.
  • 群名称 — Optional group name, up to 100 characters.
  • 群描述 — Optional group description, up to 500 characters.
  • 群头像 Image Key — Optional image key for the group avatar, obtained through Feishu’s image upload API.
  • 群主 ID — Optional group owner ID in the selected user ID format. If omitted, the group creator becomes the owner.
  • 群成员用户 ID 列表 — Optional comma-separated list of user IDs to invite when creating the group.
  • 群机器人 ID 列表 — Optional comma-separated list of bot IDs to invite when creating the group.
  • 群消息形式 — Choose chat messages or thread messages. Defaults to chat.
  • 群模式 — Group mode; currently only group is supported and is the default.
  • 群类型 — Choose a private or public group. Defaults to private.
  • 是否为外部群 — Set whether the group is external. Defaults to false.
  • 入群消息可见性 — Choose who can see join messages: owner and admins, all members, or no one. Defaults to all members.
  • 退群消息可见性 — Choose who can see leave messages: owner and admins, all members, or no one. Defaults to all members.
  • 加群审批 — Choose whether joining requires no approval or approval from the owner or an admin. Defaults to no approval.
  • 其他请求体参数 — Optional JSON object of additional Feishu create-chat request fields, such as localized names, labels, or restricted-mode settings.
  • Options — Batching enables concurrent requests for input items; set items per batch and the interval between batches. Timeout sets the request timeout in milliseconds; 0 means no timeout.

Output shape

A list of n8n items, normally one per input item, containing the Feishu create-chat response data.

If Continue On Fail is enabled, failed items are returned with an error field. Batching can run requests concurrently; otherwise requests run serially.

Links

Discussion