Listmonk icon

Listmonk

Interact with a listmonk instance for email marketing and newsletter management. Supports creating subscribers, managing campaigns, sending emails, and more.

Actions32

Subscriber → Create a New Subscriber

AI-generated

Overview

This node integrates with a list management and email marketing platform to create new subscribers. It is useful for automating the addition of contacts to mailing lists, managing subscriber statuses, and enriching subscriber profiles with custom attributes. Typical use cases include onboarding new users to newsletters, updating subscriber information in bulk, or integrating subscription forms from other applications.

For example, you can use this node to add a user who signed up on your website to your email marketing list, set their subscription status as enabled, and assign them to specific mailing lists with custom attributes like location or preferences.

Properties

Name Meaning
Name The full name of the subscriber. Required field.
Email The subscriber's email address. Must be a valid email format. Required field.
Status The subscription status of the subscriber. Options: Enabled, Disabled, Blocklisted.
Lists JSON array specifying the mailing lists to which the subscriber should be added.
Attributes JSON object containing custom attributes for the subscriber (e.g., preferences, metadata).
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 record as returned by the API. This typically includes subscriber details such as ID, name, email, status, assigned lists, and any attributes. There is no binary output.

Dependencies

  • Requires connection to a list management service via an API.
  • 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 Email Format: If the email does not match the required regex pattern, the node will reject it. Ensure the email is correctly formatted.
  • Authentication Errors: Incorrect or missing credentials will cause authentication failures. Verify API credentials are correct and have necessary permissions.
  • Invalid JSON in Lists or Attributes: The Lists and Attributes fields expect valid JSON input. Malformed JSON will cause errors.
  • Status Value Issues: Only "enabled", "disabled", or "blocklisted" are accepted for status. Using other values may result in API rejection.
  • Preconfirm Flag Misuse: Setting preconfirmSubscriptions incorrectly might lead to unexpected subscription confirmation behavior; understand your mailing list's opt-in requirements.

Links and References

Discussion