WAHA API icon

WAHA API

Complete WhatsApp automation with WAHA API - Multi-engine support
Join our community

Actions55

Overview

This node integrates with the WAHA API to automate WhatsApp group management and other WhatsApp-related operations. Specifically, the "Create Group" operation under the "Group" resource allows users to create a new WhatsApp group by specifying the group name and participants.

Common scenarios where this node is beneficial include:

  • Automating the creation of WhatsApp groups for event coordination or team communication.
  • Programmatically managing group membership and settings as part of larger workflows.
  • Integrating WhatsApp group creation into CRM or customer support systems to streamline communication channels.

For example, a marketing automation workflow could use this node to create a WhatsApp group for a new campaign and add relevant contacts automatically.

Properties

Name Meaning
Session Name The name of the WhatsApp session to use for the operation (defaults to a configured session).
Group Name The name to assign to the new WhatsApp group (required).
Participants Comma-separated list of participant chat IDs to add to the group (required).
Additional Fields Optional extra parameters such as:
- Filename: Custom filename for media files
- Mimetype: MIME type of the file
- Link Description: Description for link preview
- Link Title: Title for link preview
- Contact Name: Name for contact vCard
- Contact Number: Phone number for contact vCard
- Reaction: Emoji reaction to send
- Limit: Limit number of results
- Download Media: Whether to download media files in messages

Output

The node outputs JSON data representing the response from the WAHA API after attempting to create the group. This typically includes details about the newly created group such as its ID, name, participants, and status.

If an error occurs, the output JSON will contain an error field with the error message.

The node does not output binary data.

Dependencies

  • Requires an active WAHA API credential with a valid base URL and API key.
  • Optionally uses an additional API key credential for validating subscription via the n8n Tools API.
  • The WhatsApp session specified must be active and connected.
  • Network access to the WAHA API endpoints.

Troubleshooting

  • Invalid Credentials: If the API key or session name is incorrect or expired, the node will throw authentication errors. Verify credentials and session status.
  • Invalid Participants Format: Participants must be provided as comma-separated WhatsApp chat IDs (e.g., 5511999999999@c.us). Incorrect formatting may cause failures.
  • API Validation Failures: Errors from the n8n Tools API validation step indicate subscription or API key issues. Check your subscription status and API keys.
  • Unknown Operation or Resource: If the operation or resource is misspelled or unsupported, the node throws an error indicating unknown operation/resource.
  • Network Issues: Connectivity problems to the WAHA API endpoint will result in request failures.

Links and References

Discussion