N8N Tools - Uazapi icon

N8N Tools - Uazapi

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

Actions37

Overview

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

Common scenarios include:

  • Elevating active or responsible group members to admins to help moderate conversations.
  • Automating group management workflows where certain users need admin privileges based on external triggers.
  • Managing large groups by programmatically adjusting admin roles without manual intervention.

For example, you could use this node to promote multiple phone numbers as admins in a specific WhatsApp group after they join or meet certain criteria.

Properties

Name Meaning
Group ID The unique identifier of the WhatsApp group where participants will be promoted to admins.
Participants Comma-separated list of phone numbers (with country code) representing participants to promote. Example: 5511999999999,5511888888888
Additional Fields Optional extra parameters including:
- Reply to Message ID: ID of a message to reply to
- Delay (seconds): Delay before sending the promotion command
- Disable Link Preview: Whether to disable link previews in messages
- Mention Users: Comma-separated phone numbers to mention in the message

Output

The node outputs a JSON object containing the response from the WhatsApp API proxy service regarding the promotion request. This typically includes confirmation of success or details about any errors encountered.

The output structure is:

{
  "json": {
    // Response data from the WhatsApp API about the promote admin action
  },
  "pairedItem": {
    "item": <index_of_input_item>
  }
}

No binary data is produced by this operation.

Dependencies

  • Requires an API key credential for the Uazapi WhatsApp API service.
  • Needs configuration of instance ID and API tokens for authentication.
  • The node sends requests through a proxy endpoint hosted at https://n8ntools.io/api/v1/proxy/uazapi.
  • Proper WhatsApp group IDs and participant phone numbers must be provided.

Troubleshooting

  • Invalid Group ID: If the group ID is incorrect or the bot is not part of the group, the API may return an error. Verify the group ID and ensure the WhatsApp instance has access.
  • Incorrect Participant Numbers: Phone numbers must be in international format without spaces or special characters. Invalid numbers will cause failures.
  • Permission Errors: The WhatsApp instance must have permission to manage the group. Lack of admin rights for the bot can prevent promotions.
  • API Authentication Failures: Ensure that the API key, token, and instance ID are correctly configured and valid.
  • Rate Limits or Delays: Using the delay field incorrectly or too frequently may cause unexpected behavior; adjust delays as needed.

If errors occur, check the returned JSON error message for details and verify all input parameters.

Links and References

Discussion