Actions7
Overview
The "Get Members By Tags" operation in the Woztell node allows users to retrieve members filtered by specific tags within a selected channel. This is useful for segmenting members based on their attributes or interests, enabling targeted messaging or analysis.
Common scenarios include:
- Fetching all members tagged with certain labels (e.g., "premium", "active") to send customized campaigns.
- Extracting member lists for reporting or integration with other systems.
- Managing membership groups dynamically based on tag filters.
For example, a marketing team could use this node to get all members tagged as "VIP" and then send them exclusive offers.
Properties
| Name | Meaning |
|---|---|
| Channel | The Woztell channel to query members from. Can be selected from a searchable list or specified by ID. |
| Tags, Comma Separation | A comma-separated list of tags to filter members by. Only members matching these tags will be returned. |
| Return All | Whether to return all matching members or limit the number of results. |
| Limit, up to 100 | Maximum number of members to return if not returning all. Value between 1 and 100. |
| Cursor, Optional | Pagination cursor to fetch the next page of results when not returning all. |
Output
The node outputs JSON data containing the list of members that match the specified tag filters within the chosen channel. The structure typically includes member details such as IDs, names, tags, and other relevant metadata.
If pagination is used, the output may also include a cursor or page info to retrieve subsequent pages.
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential for authenticating with the Woztell API.
- Needs access to the Woztell service endpoint configured in the node's request defaults.
- The "Channel" property depends on the ability to search or specify valid channels within Woztell.
Troubleshooting
- Empty Results: If no members are returned, verify that the channel ID is correct and that members with the specified tags exist.
- Invalid Tags Format: Ensure tags are separated by commas without extra spaces or invalid characters.
- Pagination Issues: When using the cursor property, ensure the cursor value is valid and corresponds to the previous response's pagination token.
- API Authentication Errors: Confirm that the API key credential is correctly set up and has sufficient permissions.
- Limit Exceeded: The maxResults property must be between 1 and 100; values outside this range will cause errors.
Links and References
- Woztell Official API Documentation (for detailed API usage and authentication)
- n8n Documentation on Creating Custom Nodes