Actions17
- Get Actions
- Message Actions
- Friend Actions
- Group Actions
Overview
The Create Group operation for the "Group" resource is designed to create a new group with specified members and an optional group name. This node is useful in scenarios where you need to automate the creation of user groups, such as team formation, project collaboration spaces, or chat groups within a system that supports group-based communication or permissions.
Practical examples:
- Automatically creating a project team group when a new project is initiated.
- Setting up chat groups for event participants.
- Organizing users into functional groups for access control.
Properties
Below are the input properties relevant to the "Create Group" operation:
| Display Name | Type | Required | Description |
|---|---|---|---|
| Members | String | Yes | Danh sách ID của các thành viên trong nhóm, cách nhau bởi dấu phẩy. (List of member IDs separated by commas.) |
| Group Name | String | No | Tên của nhóm. (Name of the group.) |
Output
The output of this node is a JSON object indicating the result of the group creation operation. The structure typically includes:
{
"success": true,
"data": {
// Details about the created group, such as groupId, groupName, members, etc.
}
}
success: Boolean indicating if the group was created successfully.data: An object containing details about the newly created group (e.g., group ID, name, list of members).
If there is an error during execution, the output will include error information:
{
"success": false,
"error": "Error message",
"stack": "Stack trace (if available)"
}
Dependencies
- External Service/API: The node requires access to an external service or API that manages groups. The actual endpoint and authentication method depend on your n8n configuration and the connected system.
- API Key/Authentication: You may need to configure credentials or environment variables in n8n to authenticate requests to the external service.
Troubleshooting
Common Issues:
- Missing or Invalid Members: If the "Members" field is empty or contains invalid IDs, the group creation will fail.
- Duplicate Group Name: Some systems may not allow duplicate group names.
- API Authentication Errors: Incorrect or missing credentials can cause authentication failures.
- Network Issues: Connectivity problems between n8n and the external service can prevent group creation.
Error Messages:
"Members is required": Ensure you provide a comma-separated list of valid member IDs."Invalid group name": Check if the group name meets the requirements of the external system."Authentication failed": Verify your API credentials or connection settings in n8n."Service unavailable": The external API might be down or unreachable; check network connectivity.
How to resolve:
- Double-check all required fields.
- Ensure all member IDs exist in the target system.
- Review and update your API credentials in n8n.
- Consult logs for detailed error messages and stack traces.
Links and References
- n8n Documentation – Custom Nodes
- n8n Credentials Setup
- External API documentation for your group management system (refer to your specific integration).