Actions64
- Instance Actions
- Chat Actions
- Message Actions
- Group Actions
- Profile Actions
- Event Actions
- Integration Actions
Overview
The "Update Participants" operation in the Group resource allows managing members of a group within the Evolution API. This node operation supports adding new members, removing existing ones, promoting members to admin status, and demoting admins back to regular members. It is useful for automating group membership management tasks such as onboarding new participants, moderating group roles, or cleaning up inactive members.
Practical examples include:
- Adding multiple phone numbers to a group chat automatically.
- Removing users who have left an organization from a group.
- Promoting trusted members to admin to help moderate discussions.
- Demoting admins who no longer require elevated privileges.
Properties
| Name | Meaning |
|---|---|
| Instance Name | The name of the Evolution API instance to connect to. |
| Group ID | The unique identifier of the group whose participants will be updated. |
| Action | The type of update to perform on the members. Options: Add Member, Remove Member, Promote to Admin, Demote to Member. |
| Members | A comma-separated list of member phone numbers to apply the action to (e.g., 5511999999999,5511888888888). |
Output
The node outputs a JSON array containing the result of the update operation. Each item in the output corresponds to the response from the Evolution API after performing the specified action on the group participants. The exact structure depends on the API response but generally includes confirmation of success or details about any errors encountered.
No binary data output is indicated by the source code.
Dependencies
- Requires an active connection to the Evolution API via an API key or authentication token configured in n8n credentials.
- The base URL for API requests is
https://doc.evolution-api.com/api-reference. - Proper permissions on the Evolution API to modify group participants are necessary.
Troubleshooting
- Unsupported operation error: If the node throws an error stating the operation is unsupported, verify that the Resource is set to "groups-api" and Operation to "update-participants".
- Invalid Group ID or Members format: Ensure the Group ID is correct and the Members field contains valid phone numbers separated by commas without extra spaces.
- Authentication failures: Confirm that the API credentials are correctly configured and have sufficient permissions.
- API rate limits or network issues: These may cause request failures; check network connectivity and API usage quotas.
Links and References
- Evolution API Documentation: https://doc.evolution-api.com/api-reference
- n8n Documentation on Credentials and API integrations: https://docs.n8n.io/credentials/