Mailgroup icon

Mailgroup

Interact with a mailgroup instance
Join our community

Actions15

Overview

The node "Mailgroup" allows interaction with a mailgroup instance, specifically managing subscribers among other resources. The "Create a New Subscriber" operation enables users to add a new subscriber to the mailgroup system. This is useful in scenarios such as building mailing lists for newsletters, marketing campaigns, or any communication that requires managing subscriber information and their subscription status.

Practical examples include:

  • Adding a new user who signed up on a website to a newsletter list.
  • Importing subscribers from another platform into the mailgroup system.
  • Automatically creating subscribers based on form submissions or CRM data.

Properties

Name Meaning
Name The full name of the subscriber.
Email The email address of the subscriber.
Status The current status of the subscriber. Options: Enabled, Disabled, Blocklisted.
Lists JSON array specifying the lists to which the subscriber should be added.
Attributes JSON object containing additional subscriber attributes (custom fields).
Preconfirm Subscriptions Boolean flag indicating if subscriptions should be preconfirmed (true means no double opt-in emails sent).

Output

The node outputs JSON data representing the created subscriber's details. This typically includes the subscriber's ID, name, email, status, associated lists, and any attributes set during creation. If the node supports binary data output, it would relate to attachments or files linked to the subscriber, but this is not indicated here.

Dependencies

  • Requires an API key credential for authenticating with the mailgroup service.
  • Needs configuration of the mailgroup API domain, username, and password credentials within n8n.
  • The node uses the mailgroup REST API endpoint constructed from the provided credentials.

Troubleshooting

  • Authentication errors: Ensure the API credentials (domain, username, password) are correctly configured and have sufficient permissions.
  • Invalid JSON in Lists or Attributes: Since these fields expect JSON input, malformed JSON will cause errors. Validate JSON syntax before execution.
  • Email validation failures: The mailgroup API may reject invalid email formats; verify the email property is correctly formatted.
  • Status option errors: Only "enabled", "disabled", or "blocklisted" are accepted; using other values will cause errors.
  • Preconfirm flag misuse: Setting preconfirmSubscriptions incorrectly might lead to unexpected subscription confirmation behavior.

Links and References

Discussion