WAHA API icon

WAHA API

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

Actions55

Overview

The "Promote Participants" operation in the Group resource of this WhatsApp automation node allows users to promote one or more group participants to admin status within a WhatsApp group. This is useful for managing group permissions and delegating administrative responsibilities to trusted members.

Typical use cases include:

  • Automatically promoting new moderators when they join a group.
  • Managing group roles programmatically as part of larger workflows.
  • Enabling dynamic control over group administration without manual intervention.

For example, you could use this node to promote specific users to admins based on external triggers or events, such as onboarding new team members or escalating privileges during an event.

Properties

Name Meaning
Session Name The name of the WhatsApp session to use for the operation. Defaults to the configured default session.
Chat ID The WhatsApp group chat ID where participants will be promoted (e.g., groupid@g.us).
Participants Comma-separated list of participant chat IDs to promote to admin status.
Additional Fields Optional extra parameters (not specifically used in this operation but available).

Output

The node outputs the JSON response returned by the WAHA API after attempting to promote the specified participants. This typically includes confirmation of success or details about any errors encountered.

The output structure is:

{
  "json": {
    // API response data confirming promotion or error details
  },
  "pairedItem": {
    "item": <index_of_input_item>
  }
}

No binary data is produced by this operation.

Dependencies

  • Requires a valid WAHA API credential with an API key and base URL configured in n8n.
  • Optionally uses an additional API credential for subscription validation via the N8N Tools API.
  • The WhatsApp session specified must be active and connected.
  • Proper permissions in the WhatsApp group are required to promote participants.

Troubleshooting

  • Invalid Session: If the session name is incorrect or the session is not active, the API call will fail. Ensure the session exists and is connected.
  • Insufficient Permissions: The WhatsApp account used must have admin rights in the group to promote others. Otherwise, the operation will return an error.
  • Invalid Chat ID or Participants: Make sure the group chat ID and participant IDs are correctly formatted and valid WhatsApp IDs.
  • API Key Issues: Errors related to authentication may occur if the API key is missing or invalid. Verify credentials in n8n settings.
  • Subscription Validation Failure: If the N8N Tools API validation fails, check your subscription status and API key for that service.

Common error messages:

  • "Unknown group operation: promoteParticipants" — indicates a misconfiguration or unsupported operation; verify operation name.
  • "Invalid subscription or API key" — check API keys and subscription validity.
  • Network or timeout errors — ensure connectivity to the WAHA API endpoint.

Links and References

Discussion