MegaAPI icon

MegaAPI

Interact with MegaAPI WhatsApp service

Actions29

Overview

This node operation allows you to add participants to an existing WhatsApp group using the MegaAPI WhatsApp service. It is useful when managing group memberships programmatically, such as automating the addition of new members to a team chat or community group.

Typical scenarios include:

  • Automatically adding new users to a project group after registration.
  • Managing event groups by adding attendees dynamically.
  • Administering customer support groups by adding agents or clients.

The operation requires that you are an admin of the target WhatsApp group and that the participants being added have active WhatsApp accounts.

Properties

Name Meaning
Group JID The unique identifier of the WhatsApp group to which participants will be added. Format: group_id@g.us.
Participants Comma-separated list of participant phone numbers in the format number@s.whatsapp.net to be added to the group.

Output

The output JSON contains the status of the add participants operation along with details about each participant added. This typically includes confirmation of success or failure per participant, allowing you to verify which users were successfully added.

No binary data is output by this operation.

Dependencies

  • Requires an active MegaAPI WhatsApp service connection configured with a valid API key credential.
  • The node must be authenticated with appropriate permissions to manage WhatsApp groups.
  • The user running the operation must be an admin of the specified WhatsApp group.

Troubleshooting

  • Common issues:

    • Attempting to add participants without admin rights will fail.
    • Adding phone numbers not registered on WhatsApp will result in errors for those participants.
    • Incorrectly formatted Group JID or participant numbers can cause request failures.

  • Error messages:

    • "Unknown group operation: addParticipants" — indicates a misconfiguration or unsupported operation; ensure the correct resource and operation are selected.
    • Errors related to authorization or permissions usually mean the API token lacks required scopes or the user is not an admin.
    • Validation errors on participant format require checking the phone number formatting (number@s.whatsapp.net).

To resolve these, verify your admin status in the group, confirm participant phone numbers are valid WhatsApp users, and check API credentials and permissions.

Links and References

Discussion