Actions30
- Campaign Actions
- List Actions
- Template Actions
- Subscriber Actions
- List Segment Actions
- Transactional Email Actions
List Segment → Create
AI-generatedOverview
This node operation creates a segment within a specified list in MailWizz. It allows users to define the segment's name, match operator (whether subscribers must meet all or any conditions), and detailed conditions based on list fields and campaign activities. Additionally, advanced users can provide a custom JSON payload to fully control the segment creation process. This is useful for marketers who want to target specific subscriber groups based on complex criteria, such as engagement with campaigns or subscriber attributes.
Use Case Examples
- Create a segment named 'Active Subscribers' in a list, where subscribers must meet all specified conditions.
- Define campaign activity conditions to include subscribers who clicked or opened specific campaigns within a certain time frame.
- Use advanced JSON to customize segment creation beyond the standard UI options.
Properties
| Name | Meaning |
|---|---|
| List ID | Identifier of the list that owns the segment, required to specify where the segment will be created. |
| Segment Name | The name of the segment to be created, used to identify the segment. |
| Match Operator | Determines if subscribers must meet all conditions ('all') or any condition ('any') to join the segment. |
| Conditions | List field conditions that determine segment membership, allowing filtering based on subscriber attributes. |
| Campaign Conditions | Campaign activity conditions that refine segment membership based on subscriber interactions with campaigns. |
| Segment Data (JSON) | Advanced JSON payload merged into the request data, allowing full control over segment creation beyond the standard parameters. |
Output
JSON
json- The response data from MailWizz after creating the segment, containing details of the newly created segment.
Dependencies
- MailWizz API with appropriate API key credentials
Troubleshooting
- Ensure the List ID is valid and exists in MailWizz; otherwise, the operation will fail with a 'List not found' error.
- Segment Name and required fields must be provided; missing these will cause validation errors.
- The JSON in 'Segment Data (JSON)' must be valid JSON; invalid JSON will cause parsing errors.
- Campaign conditions require valid campaign IDs and proper time comparison parameters; incorrect values will cause request failures.