Actions148
- Send messages Actions
- Outbound Messages Actions
- WhatsApp Numbers Actions
- Groups Actions
- Channels Actions
- Chats Actions
- Chat Contacts Actions
- Chat Messages Actions
- Chat Files Actions
- Team Actions
- Labels Actions
- Departments Actions
- Files Actions
- Quick replies Actions
- Queue Actions
- WhatsApp session Actions
- WhatsApp profile Actions
- Business catalog Actions
- Campaigns Actions
- Meeting Links Actions
- User Status Actions
- Webhooks Actions
- Other Actions
Overview
This node integrates with the Wassenger WhatsApp API to create a new WhatsApp group under a specified WhatsApp number (device). It allows users to define the group's name, description, permissions, ephemeral message settings, and initial participants. This is useful for automating group creation in WhatsApp for marketing campaigns, customer support teams, or community management where groups need to be programmatically managed.
Practical examples:
- Automatically creating a customer support group when onboarding a new client.
- Setting up event-specific WhatsApp groups with predefined participants and permissions.
- Managing ephemeral message settings for groups that require temporary conversations.
Properties
| Name | Meaning |
|---|---|
| WhatsApp Number | The ID of the WhatsApp number (device) from which the group will be created. |
| Group Name | The name assigned to the new WhatsApp group. |
| Description | Optional text describing the group (up to 500 characters). |
| Group Permissions | Settings controlling who can edit group settings, send messages, invite participants, and whether new participants require admin approval. Options include: - Edit Settings Permission: All Participants / Admins Only - Send Messages Permission: All Participants / Admins Only - Invite Permission: All Participants / Admins Only - Require Approval: true/false |
| Ephemeral Messages | Controls automatic deletion of messages in the group. Options: - Off - 24 Hours - 7 Days - 90 Days |
| Participants | List of participants to add initially to the group. Each participant includes: - Phone Number (in international format) - Make Admin (boolean flag to assign admin rights) |
Output
The node outputs JSON data representing the result of the group creation operation. This typically includes details about the newly created group such as its unique identifier, name, description, permissions, ephemeral message settings, and the list of participants with their roles.
No binary data output is indicated for this operation.
Dependencies
- Requires an active connection to the Wassenger WhatsApp API via an API key credential configured in n8n.
- The node depends on the availability of the WhatsApp number (device) selected to create the group.
- Proper permissions must be granted by the Wassenger API account to perform group creation operations.
Troubleshooting
Common issues:
- Invalid or missing WhatsApp number (device) ID may cause failures.
- Providing phone numbers for participants in incorrect format (not international) can lead to errors.
- Insufficient permissions in the Wassenger API account to create groups.
- Exceeding character limits in the description field.
Error messages and resolutions:
- "Invalid device ID" โ Verify the WhatsApp number ID is correct and accessible.
- "Participant phone number invalid" โ Ensure all phone numbers are in international format (e.g., +1234567890).
- "Permission denied" โ Check API key permissions and ensure group creation is allowed.
- "Description too long" โ Limit the description to 500 characters or fewer.
Links and References
- Wassenger API Documentation (for detailed API capabilities and limitations)
- WhatsApp Group Management Best Practices