N8N Tools - Uazapi icon

N8N Tools - Uazapi

Complete Uazapi integration - Premium WhatsApp API with advanced messaging and automation

Actions37

Overview

This node operation allows you to create a new WhatsApp group using the Uazapi WhatsApp API integration. It is useful for automating group creation workflows, such as setting up customer support groups, team collaboration groups, or event-specific chat groups directly from your automation platform.

For example, you can use this node to automatically create a WhatsApp group named "Project Team" and add initial participants by specifying their phone numbers. This helps streamline communication setup without manual intervention in the WhatsApp app.

Properties

Name Meaning
Group Name The name of the new WhatsApp group to be created.
Participants Comma-separated list of phone numbers (with country code) to be added as initial members.
Additional Fields Optional extra settings:
• Reply to Message ID: ID of a message to reply to.
• Delay (seconds): Delay before sending messages.
• Disable Link Preview: Whether to disable link previews in messages.
• Mention Users: Comma-separated phone numbers to mention in messages.

Output

The output JSON contains the response from the Uazapi API after attempting to create the group. It typically includes details about the newly created group such as its ID, name, participants, and status. If an error occurs, the output will contain an error field with the error message.

No binary data is output by this operation.

Example output snippet:

{
  "groupId": "1234567890@g.us",
  "name": "My New Group",
  "participants": ["5511999999999", "5511888888888"],
  "status": "created"
}

Dependencies

  • Requires an active Uazapi WhatsApp API account.
  • Needs an API key credential and authentication token configured in n8n credentials.
  • The node uses the Uazapi API endpoint to perform group creation.
  • Proper instance ID must be set to identify the WhatsApp instance.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrectly formatted phone numbers in the participants list may result in errors.
    • Missing required fields like Group Name will prevent group creation.
    • Network or API downtime can cause request failures.

  • Error messages:

    • "Unknown resource": Indicates the resource parameter is incorrect; ensure it is set to "group".
    • API authorization errors: Check that the API key and token are valid and have not expired.
    • Validation errors from the API: Verify phone numbers and other parameters conform to expected formats.

To resolve errors, verify all input parameters, ensure credentials are correct, and check network connectivity.

Links and References

Discussion