Actions15
Overview
The node "Mailgroup" provides functionality to interact with a mailgroup instance, specifically allowing management of subscribers within mailing lists. The "Manage Subscriber List" operation enables users to add, remove, or unsubscribe subscribers from specified mailing lists and set their subscription status.
This node is beneficial in scenarios where automated email list management is required, such as:
- Adding new subscribers collected from a web form into one or more mailing lists.
- Removing users who have requested to be unsubscribed or who no longer should receive communications.
- Updating the subscription status of existing subscribers for compliance or segmentation purposes.
For example, after collecting user emails via a signup form, this node can add those emails to a confirmed subscriber list automatically. Alternatively, it can be used to unsubscribe users who click an unsubscribe link in an email campaign.
Properties
| Name | Meaning |
|---|---|
| Subscriber IDs | JSON array of subscriber identifiers to be managed (added, removed, or unsubscribed). |
| Action | The action to perform on the subscribers: Add, Remove, or Unsubscribe. |
| List IDs | JSON array of mailing list identifiers to which subscribers will be added or removed. |
| Subscription Status | The status to assign to the subscriber(s): Confirmed, Unconfirmed, or Unsubscribed. |
Output
The node outputs data in JSON format representing the result of the subscriber list management operation. This typically includes confirmation of the performed actions on the specified subscribers and lists, such as success or failure statuses per subscriber or list.
If binary data output is supported by other operations, it is not relevant here since managing subscriber lists deals primarily with JSON data.
Dependencies
- Requires connection to a Mailgroup API instance.
- Needs credentials including domain URL, username, and password for authentication.
- The base URL for API requests is constructed from the provided domain credential.
- The node expects the API to accept and return JSON-formatted data.
Troubleshooting
- Invalid Subscriber or List IDs: Ensure that the subscriber and list IDs provided are valid and exist in the Mailgroup system. Invalid IDs may cause errors or no changes.
- Authentication Errors: Verify that the API credentials (domain, username, password) are correct and have sufficient permissions.
- Action Not Supported: The action property must be one of Add, Remove, or Unsubscribe. Using unsupported values will cause failures.
- Empty Arrays: Providing empty arrays for subscriber or list IDs may result in no operation being performed; ensure these fields are populated correctly.
- API Connectivity Issues: Network problems or incorrect domain URLs can prevent successful API calls.
Links and References
- Mailgroup API documentation (refer to your Mailgroup service provider's official API docs)
- n8n documentation on creating and using custom nodes
- General REST API best practices for authentication and error handling