Listmonk Service icon

Listmonk Service

Call listmonk service endpoints.

Actions9

Overview

The node integrates with the Listmonk service to create new subscribers in mailing lists. It allows users to add subscriber details such as name, email, and status, and optionally assign them to specific subscription lists or provide additional custom attributes. This node is useful for automating subscriber management workflows, such as adding new contacts collected from forms or CRM systems into Listmonk for email marketing campaigns.

Practical examples:

  • Automatically add a new user who signed up on a website to a newsletter list.
  • Import subscribers from another system and set their subscription status.
  • Add custom metadata about subscribers for segmentation or personalization.

Properties

Name Meaning
Subscriber Name The full name of the subscriber being created.
Subscriber Email The email address of the subscriber.
Subscriber Status The current status of the subscriber; options are: "Enabled" (active) or "Blocklisted" (blocked).
Add to Subscription Lists Boolean flag indicating whether to add the subscriber to specified subscription lists.
Lists JSON array of list IDs to which the subscriber should be added (only if "Add to Subscription Lists" is true).
Provide Additional Information Boolean flag indicating whether to store extra custom data about the subscriber.
Additional Attributes JSON object containing optional additional subscriber data (only if "Provide Additional Information" is true).
Pre-Confirm Subscription Boolean flag that, if true, marks subscriptions as confirmed immediately, bypassing double opt-in emails.

Output

The node outputs JSON data representing the result of the subscriber creation operation. This typically includes details of the newly created subscriber record such as its ID, name, email, status, and any associated lists or attributes. There is no binary output.

Dependencies

  • Requires an API key credential to authenticate with the Listmonk service.
  • The node expects the Listmonk API base URL configured via credentials.
  • The Listmonk service must be accessible and properly configured to accept subscriber creation requests.

Troubleshooting

  • Invalid or missing API credentials: Ensure the API key and host URL are correctly set in the node credentials.
  • Malformed JSON in Lists or Additional Attributes: Verify that JSON inputs for lists and attributes are valid and properly formatted.
  • Subscriber email already exists: The API may reject duplicate emails depending on Listmonk settings; check for existing subscribers before creating.
  • Network or connectivity issues: Confirm that the Listmonk server is reachable from n8n.
  • Permission errors: Make sure the API key has sufficient rights to create subscribers and modify lists.

Links and References

Discussion