Evolution API icon

Evolution API

Complete WhatsApp automation with Evolution API
Join our community

Actions48

Overview

The node integrates with the Evolution API to automate WhatsApp group management tasks. Specifically, the "Create Group" operation allows users to create a new WhatsApp group by specifying a group name and participants. This is useful for automating group creation workflows such as setting up customer support groups, team collaboration channels, or event-specific discussion groups.

For example, a user can automatically create a WhatsApp group for a new project team by providing the project name as the group name and listing team members' phone numbers as participants.

Properties

Name Meaning
Group Name The name/title of the new WhatsApp group to be created.
Participants Comma-separated list of phone numbers (including country code) to add as initial members.
Additional Fields Optional settings including:
- Delay: Time in milliseconds before sending the request.
- Link Preview: Enable/disable link previews in messages.
- Quoted Message ID: ID of a message to quote/reply to.
- Mentions: Comma-separated list of numbers to mention in messages.

Output

The node outputs a JSON object representing the response from the Evolution API after attempting to create the group. This typically includes details about the newly created group such as its unique identifier, subject (group name), and participant list.

If an error occurs, the output JSON will contain an error field describing the issue.

No binary data is produced by this operation.

Dependencies

  • Requires valid credentials for the Evolution API, including:

    • Base URL of the API
    • API key for authentication
    • Instance name identifying the WhatsApp instance to operate on

  • Optionally uses credentials for an auxiliary API ("N8N Tools API") for subscription validation.

  • The node makes HTTP POST requests to the Evolution API endpoints.

Troubleshooting

  • Invalid Credentials: If the API key or instance name is incorrect, the node will fail to authenticate. Verify that the provided API key and instance name are correct and active.

  • Subscription Validation Failure: The node validates the subscription via an external API. Errors like 401 or 403 indicate invalid subscription or API key for this validation service.

  • Malformed Participants List: Ensure the participants string is a comma-separated list of phone numbers with country codes and no extra spaces or invalid characters.

  • API Endpoint Errors: If the Evolution API returns errors, check the error message in the output JSON for details. Common issues include invalid group names or exceeding participant limits.

  • Network Issues: Connectivity problems may cause request failures. Confirm network access to the Evolution API base URL.

Links and References

Discussion