Actions83
- Instances Actions
- Client Actions
- Message Actions
- Chat Actions
- Contact Actions
- Number Actions
- Group Actions
- Channel Actions
- Label Actions
- Story Actions
Overview
This node allows you to create a new WhatsApp group using the WaAPI service. It is useful for automating group creation workflows, such as setting up discussion groups, customer support groups, or event coordination groups on WhatsApp. For example, you can use this node to programmatically create a group with a specific name and add multiple participants by their WhatsApp contact IDs.
Properties
| Name | Meaning |
|---|---|
| Id | Instance ID of the WhatsApp client to use for creating the group (a numeric identifier). |
| Group Name | The name/title of the WhatsApp group to be created. |
| Group Participants | A JSON array of WhatsApp contact IDs (in the format number@c.us) to add to the group. |
Output
The node outputs JSON data representing the response from the WaAPI service after attempting to create the group. This typically includes details about the newly created group such as its ID, name, participants, and status. There is no indication that binary data is output by this node.
Dependencies
- Requires an API key credential for authenticating with the WaAPI service.
- The node uses the WaAPI REST API endpoint at
https://waapi.app/api/v1. - Proper configuration of the API key credential in n8n is necessary for successful requests.
Troubleshooting
- Common issues:
- Invalid or missing API key credential will cause authentication failures.
- Incorrectly formatted participant IDs (not following the expected WhatsApp ID format) may result in errors or failure to add participants.
- Providing an invalid instance ID or one that does not correspond to an active WhatsApp client may cause the request to fail.
- Error messages:
- Authentication errors usually indicate problems with the API key; verify the credential setup.
- Validation errors may occur if required fields like group name or participants are missing or malformed; ensure all required properties are correctly set.
- Network or service errors might happen if the WaAPI service is unreachable; check network connectivity and service status.
Links and References
- WaAPI Official Documentation (for detailed API usage and parameters)
- WhatsApp Group Creation Guidelines (for understanding WhatsApp group constraints)